CONTENTS 


PREFACE ix 

SUMMARY OF TECHNICAL CHANGES xiii 

CHAPTER 1 Introduction 

Gaining Access to Files and Accounts . 1-2 

Read and Execute Access. 1-2 

Write Access.1-3 

Create/Rename Access .. 1-3 

Using CCL Commands to Run System Utility Programs 1-3 

Using CCL Commands from the DCL Command 

Environment.1-5 

Using CCL Commands from a Non-DCL Command 
Environment... 1-5 


CHAPTER 2 System Utilities 


Copying Between Like Devices: The COPY Program . . 2-1 

Privilege Required . 2-2 

Running the COPY Program.2-2 

COPY Switches.2-3 

COPY Error Messages . ..2-6 

Listing File Directories: The DIRECT Program . . . 2-7 

Privilege Required . 2-7 

Running the DIRECT Program ..2-7 

Wildcard Specifications . 2-9 

DIRECT Switches . 2-11 

DIRECT Examples . 2-15 

DIRECT as a CCL Command ..2-17 

File Attributes.2-18 

DIRECT Error Messages . 2-23 

Comparing Files: The FILCOM Program . 2-25 

Privilege Required . 2-25 

Running FILCOM. 2-25 

FILCOM Prompts . 2-26 

FILCOM Single Command Line . 2-28 

FILCOM Switches . 2-29 

Wildcards . . . ;. 2-32 

FILCOM Examples . 2-34 

FILCOM Error Messages. 2-38 

Transferring Files Between Devices: The FIT 

Program. 2-40 

Privilege Required . 2-40 

Running the FIT Program. 2-41 

Transferring Files with FIT. 2-41 

Listing the Directory of a Device. 2-44 

Deleting Files on an RTll Structured Device . 2-45 


iii 






































Initializing an RT11 Structured Device .... 2-46 

Compressing an RTll Structured Device .... 2-48 

Maintaining RTll Format with Bad Block Files . 2-48 

FIT Error Messages. 2-49 

Transferring Diskette Information: The FLINT 

Program. 2-52 

Privilege Required . 2-52 

Running FLINT: The Initiation Commands .... 2-53 

Listing the Directory of an IBM Diskette . . . 2-53 

Transferring IBM Diskette Data to RSTS/E . . . 2-56 
Specifying the Known Diskettes of a Data Set . 2-59 
Format of RSTS/E Disk File Header Records . . 2-59 

Transferring RSTS/E Files to IBM Diskettes . . 2-60 

Initializing and Erasing a Diskette . 2-63 

FLINT Dialogue Examples: /DIRECTORY, /TORSTS, 

/TOIBM, /ZERO, and /ERASE . 2-64 

FLINT Error Messages . . . .. 2-66 

Communicating with the System Manager: The GRIPE 

Program. 2-68 

Privilege Required . 2-68 

Sending a Message. 2-68 

The *LIST Command. 2-69 

The *RESET Command. 2-71 

GRIPE Error Messages. 2-72 

Obtaining Help: The HELP Program . 2-73 

Privilege Required . 2-73 

Running the HELP Program. 2-73 

HELP as a CCL Command. 2-76 

Manipulating Address Space Locations: The ODT 

Program. 2-79 

Privilege Required . 2-79 

How ODT Works. 2-79 

Running and Terminating ODT. 2-83 

Accessing Locations in the Address ..Space . . . 2-84 

Opening the Preceding Location . : 2-87 

Opening a PC Relative Location . 2-88 

Opening an Absolute Location . 2-89 

Opening a Relative Branch Offset Location . . 2-89 

Returning to an Interrupted Sequence . 2-91 

Printing the Contents of a Range of Locations 2-91 

Printing ASCII Format . 2-92 

Printing Radix-50 Format . 2-93 

Relocation Registers . 2-93 

Interpretive Address Quantities . 2-95 

Error Procedures. 2-96 

Device Transfer: The PIP Program . 2-97 

Privilege Required . 2-97 

Running the PIP Program. 2-97 

PIP Command Line Specifications . 2-98 

Wildcard Specifications . 2-101 

DCL Command Files in PIP. 2-103 

PIP Switches: An Overview. 2-105 

iv 


















































File Transfer Operations . 2-112 

Wildcard Usage in File Transfer Operations . . 2-115 

The Help Switch.2-116 

The Access Switch. 2-117 

The Append and Extend Switches . 2-117 

The ASCII Switch.2-117 

The Block Switch.2-118 

The Block Size Switch.2-119 

The Cluster Size Switch.2-120 

The Go or Ignore Switches.2-120 

The Mode Switch ..2-120 

The New File and Retain Switches.2-121 

The No Attributes Switch. 2-121 

The No Supersede Switch.2-121 

The Run-Time System Name Switch . 2-122 

The Update Switch.2-122 

Date Related Switches . 2-125 

The File Operation Switches - .2-127 

The File Deletion Switches.2-128 

The File Rename Switch.2-129 

The Directory Listing Switches . 2-129 

The Initializing Directories Switch . 2-132 

The /LOCK and /PRIOR Switches ........ 2-134 

Multivolume ANSI Magnetic Tape File Transfer . 2-134 

PIP Error Messages. 2-137 

Formatting a Post-Mortem Dump: The PMDUMP 

Program ..2-138 

Privilege Required . 2-138 

When to Use PMDUMP.2-138 

Running the PMDUMP Program . 2-139 

Contents of the Post-Mortem Dump.2-140 

Submitting Requests to the OPSER-Based Spooler: 

The QUE Program . . . . ..2-149 

Privilege Required. 2-149 

Running QUE at a Terminal.2-150 

Using the Q Command.2-153 

Q Command File Specifications . ..2-157 

Using Wildcard Characters in File 

Specifications . 2-158 

Q Command Examples .....; . 2-160 

Using the L and S Commands.2-161 

Using the K Command. 2-164 

Using the M Command.2-165 

Running QUE Using CCL Commands.2-166 

Error Messages and Codes.2-167 

Restoring Pre-V9.0 Backed-Up Files: The RESTOR 

Program.2-170 

Privilege Required . 2-170 

RESTOR and System Management . 2-170 

How RESTOR Works.2-171 

User Dialogue.2-171 

File Selection.2-171 


v 

















































2-24 LIST Dialogue Summary.2-186 

2-25 RESTOR Interruption Commands . 2-188 

2-26 RESTOR Dialogue Error Messages . 2-192 

2-27 RESTOR Interruption Command Error Messages . . . 2-194 

2-28 RESTOR Volume Mount Error Messages . 2-194 

2-29 SYSTAT Switches.2-218 

2-30 Abbreviations for Full SYSTAT Report.2-226 

2-31 Abbreviations for Open File Reports.2-231 

A-1 Control Statement Special Characters.A-5 

A-2 Command-Related File Specification Defaults . . . A-8 

A-3 File Specification Defaults . A *9 

A-4 Batch Processor Command Set . A-10 

A-5 Batch Processor Error Messages . A-33 


vi ii 
















1 


Preface 


Objectives 

This manual describes RSTS/E system utility programs. Taken together, 
the utilities comprise a set of general purpose programs that can 
assist you in a variety of ways ranging from file transfer to 
directory listing operations. This manual describes the purpose and 
use of each utility in detail. 


Audience 

This RSTS/E Utilities Reference Manual is for anyone who uses the 
RSTS/E operating system. The utilities that return information to the 
user, such as DIRECT and HELP, are particularly useful to 
inexperienced users. On the other hand, file transfer utilities such 
as PIP can greatly assist the experienced RSTS/E user. 


Document Structure 

This manual has two chapters and one appendix: 

Chapter 1 Introduces the system utilities and summarizes their 

use. 

Chapter 2 Describes each system utility in detail. 

Appendix A Describes the OPSER-Based Batch Processor control 

statements. 


Related Documents 

This manual references the following manuals where appropriate: 

The RSTS/E Task Builder Reference Manual tells how to use the Task 
Builder to link compiled or assembled programs and subprograms into an 
executable program file to run on RSTS/E: 

The RSTS/E Programmer's Utilities Manual describes the RSX-based 
utility programs available to RSTS/E users. 

The RSTS/E RTll Utilities Manual describes the RTll-based utilities 
that MACRO and FORTRAN IV programmers need to develop programs on 
RSTS/E and RT-11 systems. 
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The RSTS/E System User's Guide explains the use of the RSTS/E 
operating system and the DIGITAL Command Language (DCL). 

Conventions 

This manual uses the following conventions: 


<RET> 

Represents the RETURN key on your terminal. 

<LF> 

Represents the LINE FEED key on your terminal. 

CTRL/x 

A 

Indicates a control key combination, such as 

CTRL/2 or CTRL/W. To enter a control key combination, hold 
the CTRL key down while you press the indicated key. 

The circumflex preceding an uppercase character indicates 
a control character. For example, “Z indicates the 
combination of the CTRL key and the Z character and can 
also be expressed as CTRL/Z. All control key combinations 
echo on your terminal screen as ~x. For example, if you 
hold the CTRL key and press the Y key, your screen echoes 
~ Y. 

color 

Red print used in examples indicates characters that you 
type. 

UPPERCASE 

In statement descriptions, you must type items that appear 
in capital letters exactly as shown. 

[ ] 

Square brackets indicate an optional statement element. 

For example: 

/W[ATCH] 

The required part of the switch is /W. 


Most examples in this manual do not show the RETURN key <RET> symbol. 
If you try examples at your terminal, always press the RETURN key when 
you finish typing a command unless the example indicates otherwise. 


x 






Terms 


This manual uses 
System 

Print and Type 
Command 

Program 

Utility 


the following terms: 

This refers to the RSTS/E operating system. 

The system prints and you type. 

An instruction that directs a system program to 
perform an operation. 

The series of commands that make up the system 
utility. 

One of the general purpose programs that this manual 
describes. 
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Summary of Technical Changes 

The following changes have been made to the utilities for V9.0: 

o MONEY, QUOLST, SWITCH, TTYSET, and UMOUNT have been deleted. 
The functions of these utilities* have been replaced by DCL 
commands. See the RSTS/E System User's Guide and the RSTS/E 
System Manager's Guide for more information. 

o ODT, RESTOR, and TALK have been moved from the RSTS/E System 
Manager's Guide to this manual. RESTOR retains the RESTORE 
functions previously included in the SAVE/RESTORE system 
program. 

o LOGIN and LOGOUT have been moved to the RSTS/E System User's 
Guide. 

o DCL commands duplicate some or all of the functions performed 
by many of the utility programs documented in this manual. 

See the RSTS/E System User's Guide and the RSTS/E System 
Manager's Guide for more information. 
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Chapter 1 
Introduction 


This manual 
systems. 


describes utility programs that are available on RSTS/E 


RSTS/E^'uciar re 3 eneral P ur P° se Programs that DIGITAL supplies to the 
l' OU Can run 311 of the utilities that thii manual 
escribes from any command environment that RSTS/E supports. 

alnhahlf^ describes the RSTS/E utilities, which are arranged in 
alphabetical order. Appendix A describes the OPSER-Based Batch 
Processor command statements. eaten 


Table 1-1 gives an overview of the utilities, 
perform, and their location in the manual. 


the functions they 


Table 1-1: Overview of System Utility Programs 


Utility 

1 

Function 

1 Page 

| Number 

BATCH 

I OPSER-Based Batch Processor control 

1 statements 

i 

1 

| A-1 

COPY 

| Copying between devices 

1 2-1 

DIRECT 

I Listing a directory 

1 

1 2-7 

FILCOM 

1 

I Comparing contents of files 

1 

1 

I 2-25 

FIT 

| Transferring files between devices 

1 

| 2-40 

FLINT 

1 

| Transferring between IBM flexible 

| diskettes and RSTS files 

1 

1 

| 2-52 

1 

GRIPE 

1 

| Sending a message to the system manager 

1 

2-68 
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Table 1-1: Overview of System Utility Programs (Cont.) 


Utility 

1 

1 

Function 

| Page 

| Number 

HELP 

1 

1 

1 

1 

Obtaining information about system 
programs 

1 

| 2-73 

1 

| 

ODT 

1 

1 

1 

Manipulating address space locations 

| 2-79 

1 

PIP 

1 

1 

I 

i 

Transferring and maintaining RSTS/E files | 2-97 

PMDUMP 

1 

1 

1 

Formatting a post-mortem dump 

| 2-138 

j 

QUE 

1 

1 

I 

Submitting requests to a spooler 

| 2-149 

RESTOR 

1 

1 

1 

Restoring pre-V9.0 backed-up files 

| 2-170 

j 

SYSTAT 

1 

1 

Obtaining a system status report 

| 2-216 

TALK 

1 

1 

Communicating with other terminals 

| 2-235 


Gaining Access to Files and Accounts 

Many RSTS/E utilities require you have read, write, or execute access 
to files or be able to create/rename files. RSTS/E controls access to 
files and accounts based on the file protection code and your 
privileges. The file protection code specifies read and write access 
for the file's owner, for other users within the owner's group, and 
for all other users on the system. For executable files, the 
protection code specifies execute and Read/Write access for owner, 
group, and all other users. Your privileges can override the file 
protection code in some cases. 


Read and Execute Access 

Depending on the file protection code, you can have read access to 
your own files, files in your group, or files not in your group. 
Regardless of th§ protection code, you have read access to your own 
files and files in your group if you have GREAD privilege, and read 
access to all files if you have WREAD privilege. These same 
conditions also control execute access. 
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Write Access 


Depending on the file protection code, you can have write access to 
your own files, files in your group, or files not in your group 
(except those in [0,*]). Regardless of the protection code, you have 
write access to your own files and files in your group if you have 
GWRITE privilege, and write access to all files (except those in 
[0,*]) if you have WWRITE privilege. 

You have write access to files in [0,*] if the file protection code 
allows world write access and you have SYSIO privilege. Regardless of 
the file protection code, you have write access to these files if you 
have WWRITE and SYSIO privileges. 


Create/Rename Access 


The ability to create new files and to rename existing files does not 
depend on the file protection code but does depend on the account in 
which you want to operate and your write privileges. You can always 
create and rename files in your own account. You can create and 
rename files in another account if you are in the same group and you 
have GWRITE privilege. You can create and rename files in any account 
(except [0,*]) if you have WWRITE privilege. 


You can create and rename files in [0,*] if you have WWRITE and SYSIO 
privileges. 


Using CCL Commands to Run System Utility Programs 

The Concise Command Language (CCL) lets you type a user-defined 
command name to run a utility program instead of the traditional RUN 
command. 

The advantages of using a CCL command is that it: 


o Invokes the program using a shorter command name. For 
example, you can define SY to be the CCL command for the 
SYSTAT utility. 

o Lets you bypass program dialogue by including all commands on 
a single command line. For example, if SW is the CCL command 
for the SWITCH utility, you can switch to the BASIC-PLUS 
keyboard monitor by typing SW BASIC. 



o 


Returns you to the system keyboard monitor after running the 
program. 
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Your system manager uses the DIGITAL Command Language (DCL) command 
DEFINE/COMMAND/SYSTEM to define CCL commands. The definition 
associates a CCL command name (usually an abbreviation or a truncated 
version of the utility program name) with the utility program 
executable image. A CCL command name can be any name that complies 
with the naming rules outlined in the RSTS/E System Manager's Guide. 
To find out what CCL commands are defined on your system, check with 
your system manager or type the DCL command SHOW COMMAND/SYSTEM/ALL. 

Table 1-2 lists some typical CCL commands and describes their 
function. 


Table 1-2: Typical CCL Commands 


+.+ 

| Utility | 

+.+ • 

DIRECT 


FLINT 

HELP 

PIP 


QUE 


SYSTAT 


CCL Command 

DIR 

DIR filespec 
DIR/switch(es) 

FLI 

HE topic 

PIP 

PIP [command line] 
QUE 

QUE/[command line] 

SY 

SY/switch( es) 


I 


Function 


Displays a standard directory 
listing of your account 

Displays a directory listing of the 
file you specify 

Displays a directory listing 
according to the switches you 
specify 

Runs the FLINT program 

Lists information on system 
programs and resources (use, 
command syntax,., etc. ) 

Runs the PIP program 

Executes [command line] as a 
standard PIP command 

Runs the QUE program 

Executes [command line] as a 
standard QUE command 

Displays a standard system status 
report 

Displays a system report according 
to the switches you specify 


■ + 

I 

■ + 
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Using CCL Commands from the DCL Command Environment 

RSTS/E lets you type both DCL and CCL commands. CCL commands have 
been available on RSTS for many years and are specific to RSTS/E. DCL 
is more recent and is now the default keyboard monitor on RSTS/E 
systems. 

DCL lets you truncate DCL command keywords. You can always truncate 
DCL keywords to the four leftmost characters, and even to two or three 
characters, as long as the remaining characters are unique within DCL. 
For example, you can type DIR or DIRE for the DIRECTORY command. 

Some RSTS/E utility program names are the same as (or truncated 
versions of) DCL keywords (for example, COPY, HELP, and DIRECT). 
Therefore, you can define CCL command names that DCL accepts as DCL 
keywords because DCL takes precedence over CCL when operating from the 
DCL environment. To avoid this conflict, you can: 

o Select CCL command names that are not the same as (or 

truncated versions of) DCL keywords. For example, define HLP 
as the CCL command name for the HELP utility. 

o Add the prefix CCL to the CCL command name. For example, if 
DIR is the CCL command name for the DIRECT utility, type CCL 
DIR to run the DIRECT utility. You can always use the CCL 
prefix with any CCL command from any command environment. 

o You can always run the utility by using the RUN command. For 
example, type RUN AUXLIB$:COPY to run the COPY utility. 


Using CCL Commands from a-Non-DCL Command Environment 

In non-DCL environments there is no conflict between CCL and DCL 
command names because you must prefix all DCL commands with the dollar 
sign ($) character. For example, if DIR is the CCL command name for 
the DIRECT utility, type DIR to run the utility. To use DIR as a DCL 
command, type $DIR. If DIR is not a CCL command and you type DIR, you 
receive an error message. 

You may have to consider precedence rules to avoid conflicts between 
CCL command names and keyboard monitor commands. See the RSTS/E 
Programming Manual for more information. 
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Chapter 2 
System Utilities 


Copying Between Like Devices: The COPY Program 

Use the COPY program to copy all of the information on a device to 
another device of the same type. You can also use COPY to verify that 
the information on two like devices is identical. 

Note 

Do not confuse the RSTS/E COPY utility with the DCL 
COPY command. You can use the DCL COPY command to 
copy individual files or groups of files, and to merge 
multiple files into a single file. See the RSTS/E 
System User's Guide for more information about the DCL 
COPY command. 

You can use COPY for the following devices: DECtapes, magnetic tapes, 
and all disks supported by RSTS/E. DIGITAL recommends using COPY for 
small disks. 

The COPY program has the following limitations: 

o Use COPY only for magnetic tape to magnetic tape transfer, 
DECtape to DECtape transfer, or disk to disk transfer. You 
cannot use COPY to transfer information between dissimilar 
devices. 

o COPY transfers all of the information on a device; you cannot 
specify individual files. 

- o COPY does not detect bad blocks on the new (output) device. 
Therefore, DIGITAL does not recommend using COPY to back up 
data on devices that allow bad blocks (DB, DM, and the DR 
series of disks, for example). 

o You cannot use COPY to transfer a bootable magnetic tape 

between tapes of different densities. The bootstrap block on 
the tape works in only one density. 
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COPY 


Privilege Required 

To run the COPY program, you need the following: 

o When copying tapes, you need DEVICE privilege if either or 
both drives is a restricted device. 

o When copying disks, you need RDNFS privilege for the input 
disk and WRTNFS privilege for the output disk. 


Running the COPY Program 
To run COPY, type: 

$ RUN AUXLIB$:COPY 

COPY displays a header, followed by a number sign (#) prompt, which 
indicates that the program is ready to receive instructions. For 
example: 

COPY V9.0 RSTS V9.0 
# 

To copy a device, respond to the prompt using the following command 
format. Note that you must include the fast copy switch (/FC): 

#new device«old device/FC 

For example: 

#DT1:=DT2:/FC 

In this example, the program copies all of the data, programs and 
directories block by block, from DECtape unit DT2 to DECtape unit DTI. 
When the process is complete, the DECtape on DTI is an exact duplicate 
of the DECtape on DT2, while the original information on unit 2 
remains intact. The next section describes the /FC switch in detail. 

After COPY successfully transfers the information from one device to 
another, the program again prompts for input. 
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COPY Switches 

You can specify one or more switches in the COPY command line. 

Table 2-1 lists the COPY switches and briefly describes their meaning. 
Table 2-1 i COPY Switches 


Switch 

| Format 

1 Meaning 

Blocksize 

1 

| /BL:n 

1 

| Specifies the blocksize used when copying. 

i 

Density 

I /DE:n 

1 

| 

1 

| Specifies the density setting when copying 
| magnetic tapes. 

Fast copy 

1 /FC 

1 

1 

| Directs the program to copy the image on the 
j input device to the output device. 

Help 

1 /HE 

| 

| Displays a help message on your terminal. 

No copy 

1 /NC 

1 

1 

1 

j Used in conjunction with /VE, directs the 
| program not to copy the information, but only 
| to verify that the information on two devices 

j is identical. 

1 

Parity 

1 

| /PA:n 

i 

i 

1 

| Specifies the parity setting when copying 
j magnetic tapes. 

1 

Verify 

1 /VE 

1 

1 

| Used in conjunction with /FC or /NC, directs 
j the program to verify that the information on 
j two devices is identical. 


/BL (blocksize) 

The /BL switch, which specifies blocksize, speeds up copying or copies 
magnetic tapes written with nondefault record sizes. To speed up 
copying, specify a larger blocksize. For example: 

#DK0:=DKl:/BL:2048/FC 

This command directs COPY to transfer the contents of the disk on 
drive DKl to the disk on drive DKO, using 2048-byte blocks, rather 
than the default of 512-byte blocks. 
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/DE (density),/PA (parity) 

The /DENSITY:d and /PARITYip switches specify nondefault density and 
parity settings when copying magnetic tapes. You can abbreviate these 
switches to /DE:d and /PA:p. In these switches: 


p Can Be: 

ODD 

EVEN 


d Can Be: 

800 

DUMP (800 bpi) 

1600 (phase encoded) 

Do not use COPY to transfer a bootable magnetic tape between tapes of 
different densities. The bootstrap block on the tape works in only 
one density. 

The following example'shows the use of the /DE:d and /PA:p switches: 

# MT0:/DE:8 0 0/PA:EVEN-MTl:/FC 

In this example, COPY writes the information on tape unit MT1 to tape 
unit MT0, at 800 bpi, even parity. 

/FC (fast copy) 

The /FC switch directs the COPY program to transfer the image on the 
input device to the output device. The information on the input 
device remains unchanged. You must include the /FC switch in the 
command line when you want to copy information. 


/HE (help) 

Type /HE in response to COPY'S number sign 
help message on your terminal. 


(#) prompt to display a 


/VE (verify), /NC(no copy) 

The /VE switch directs the program to confirm that the information on 
two devices is identical. You can use the /VE switch in two ways: 

o When you use the /VE and the /FC (fast copy) switches 

together, the program first copies the information and then 
verifies that the copied information is correct. 

o When you use the /VE and /NC (no copy) switches together, the 
program verifies only that the information on the two 
specified devices is identical. 
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The following two examples show the use of the /VE switch: 

#DT1:=DT2 j/FC/VE 

In this example, the program first copies the information from DECtape 
unit DT2 to DECtape unit DTI. Then the program verifies that the 
copied information is correct. Because COPY performs the verification 
block by block, verification requires as much time as copying. 

If you only want to confirm that the information on two devices is 
identical, use the /NC and /VE switches. For example: 

# DTI:«DT2:/NC/VE 

In this example, COPY does not copy information; the program only 
verifies that the information on the two DECtapes is identical. 

The two sample commands are the only allowable forms for verifying. 

As with the /FC switch, you cannot specify individual files with the 
/VE switch; it verifies all of the information on a device. 

When COPY begins verification, the program displays the following 
message: 

BEGINNING VERIFICATION PASS 

If the program copies the information correctly, the program displays 
the following message: 

VERIFICATION COMPLETE 0 BAD BLOCKS 

However, if the program does not copy the information correctly, COPY 
displays the number of blocks (in decimal) in which inconsistencies 
appear. For example: 

#DT1: *=DT2 : /FC/VE 

BEGINNING VERIFICATION PASS 

THE FOLLOWING BLOCKS ARE BAD: 

17 

31 

89 

VERIFICATION COMPLETE 3 BAD BLOCKS 
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COPY Error Messages 

Table 2-2 lists the COPY error messages and their meanings. 
Table 2-2: COPY Error Messages 


Message and Meaning 


?CANNOT SPECIFY BOTH /FC AND /NC 

You specified both the /FC and /NC switches in the same command 
line. 

?ERROR IN SPECIFYING DENSITY (or PARITY) 

You used a density (or a parity) that COPY does not support. 

TERROR IN SPECIFYING SWITCHES 

You misplaced or mistyped a switch. 

?/FC OR /NC MUST BE SPECIFIED 

You failed to specify the /FC switch in the command line for a 
copy procedure, or you failed to specify either the /FC or /NC 
switch in the command line for a verification procedure. 

?ILLEGAL BLOCK SIZE 

You specified an illegal blocksize. 

’ILLEGAL DEVICE 

You specified an illegal or nonexistent device. 

TILLEGAL INPUT (or OUTPUT) SPECIFICATION 

You incorrectly specified the device in the input (or output) 
specification. 

’MUST HAVE DIFFERENT UNIT NUMBERS 

You specified the same device unit number twice. 

’MUST HAVE SAME TYPE DEVICES 

You attempted to copy information from one type of device to a 
different type of device. 

?NO HELP FILE EXISTS 

The file COPY.HLP does not exist or resides in the wrong 
account. 

’SYNTAX ERROR IN COMMAND STRING 

You typed a command string that COPY cannot interpret. 
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Listing File Directories: The DIRECT Program 


The DIRECT program lists information, stored in a disk 
about files. DIRECT opens the directory as a file and 
information by immediately accessing the blocks in the 


directory, 
reads the 
directory. 


Privilege Required 

To run the DIRECT program, you need the following: 

o Create/Rename access to any output file you specify 

° vonr ™ eSS t0 any file you dis P la y from accounts other than 


Running the DIRECT Program 
To run DIRECT, type: 

$ RUN $DIRECT 

DIRECT prints a header line followed by a number sign (#) prompt: 

DIRECT V9.0 RSTS V9.0 
# 

In response to the prompt, type a command line that has the format: 

[output.][input[/sw]...][,input[/sw]...],... 
where: 


output 


specifies the destination of the directory information. 
You s P ecif Y a device specification or a disk file 
specification. if you omit the file type in the output 
file specification, DIRECT assigns the default file 
type .DIR unless you force a null file type by 
including a period (.) after the file name. If you 
omit the output file specification, DIRECT displays the 
output on your terminal. if you do not specify output, 
also omit the ** symbol. 
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input 

specifies the disk files you want listed. You can 
specify any number of full disk file specifications. 

The file specification can include a device, file name, 
file type, and project/programmer-number (PPN) If you 
do not specify a device, DIRECT assumes the public 
structure and denotes it by displaying SY: in the 
directory listing. If you do not specify any input 
specification, DIRECT lists information about all files 
in your current account on the public structure. If 
you specify more than one input specification, separate 
each with a comma (,). 

/sw 

specifies one or more switches you want to include with 
each input specification. These switches let you 
tailor the directory information to your specific 
needs. If you do not specify any switches for an input 
specification, DIRECT proceeds as if you had specified 
the /DI switch. DIRECT includes a heading, file name, 
file type, size, protection code, creation date, and 
ending summary line. If you specify more than one 

switch for an input specification, include a slash (/) 
with each switch. 


The following example shows the results of the DIRECT program: 

$ RUN SDIRECT 
DIRECT V9.0 RSTS V9.0 


# LPO: 

:=ESC.BAS,MAIL.MAI 

Name 

ESC 

.Typ Size Prot Date SY:[3,214] 

.BAS 1 < 60> 15-Jun-85 


Total of 1 block in 1 file in SY:[3,214] 

Name .Typ Size Prot Date SY:[3,214] 

MAIL .MAI 21 < 60> 09-Apr-85 

Total of 21 blocks in 1 file in SY:[3,214] 

Items reported are: 

Item Description 

Name.Typ File name and type 


Size 

Size (in 512-byte blocks) of each file 

Prot 

Protection code 

Date 

Date of creation 
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Item 
(Disk) 


(Summary) 


Description 

Disk where the file resides, and the user's PPN. In 
the previous example, DIRECT displays information about 
the files located on the system disk (SY:) in user 
account [3,214]. 

Summary line that includes the total number of blocks 
used, the number of files listed, and the disk location 
and PPN of the user's account. 

Note 


Because the DIRECT program follows pointers through a 
disk directory, the program may display incorrect 
information if a user changes the pointers during 
program execution. For example, this may occur if 
another user opens a file in the current account while 
you are running DIRECT. 

On completion of the directory listing, DIRECT returns to the command 
level # prompt. You can specify another directory listing or exit 
from DIRECT by entering CTRL/Z. 


Wildcard Specifications 

You can substitute the asterisk (*) character and the question mark 
(?) character wildcards in the file name and file type fields. In 
addition, you can substitute the * character in the PPN field. 

You can substitute the * character for the entire file name, the 
entire file type, both the file name and file type, and the entire 
file specification. For example: 


File Name 

and Type Meaning 


* . TBL 

Substitute 

for 

file 

name 

FILE.* 

Substitute 

for 

file 

type 

*.* 

Substitute 

for 

file 

name and type 

★ 

Substitute 

for 

file 

specification 
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The following shows the default interpretations of the * character 
wildcard that DIRECT applies to file specifications: 

DIRECT 


User Types 

Interprets As 



Files Listed 


null(RET) 

*. * 

All 

files 



* 

*.* 

All 

files 



* 

• 

★ * 

• 

All 

files 



* 

• 

*. 

All 

files 

having a null file 

type 

• 

*. 

All 

files 

having a null file 

type 

.TYP 

* . TYP 

All 

files 

having .TYP file type 

FILE 

FILE.* 

All 

files 

having a FILE file 

name 

You can also 

use the ? character 

wildcard to 

substitute for one 

or 


more alphanumeric characters in the file name and/or file type fields. 
Although you can substitute the ? character for each of the six 
characters of the file name and the three characters of the file type, 
it is simpler to use the * character in these cases. Therefore, you 
would usually mix ? characters with alphanumeric characters of the 
file name and file type. You can include ? characters in the file 
name and still use the * character for the file type and vice versa. 
For example: 

User Types 

DIRE??.DIR 

B?????.TBL 

FILE.B?? 

PROG??.* 

*. BA? 


Files Listed 

All files having DIRE as the first four characters 
in their file name and having a .DIR file type 

All files whose names start with B and have a .TBL 
file type 

All files with file names of FILE and file types 
starting with B 

All files with PROG as the first four characters 
in their file name 

All files with BA as the first two characters in 
their file types 
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You can substitute the * character for the project number, the 
programmer number, or both (PPN). For example: 


PPN 

[*,214] 

U,*] 

[*,*] 


Meaning 

Substitute for the project number 
Substitute for the programmer number 
Substitute for PPN 


DIRECT Switches 


You can specify one or more switches with 
specification. If you do not include any 
specification, DIRECT uses the /DI switch 


each input file 
switches for an input 
as the default. 


file 


Table 2-3 lists the DIRECT switches and their meaning. 


Table 2-3: DIRECT Switches 


+. 

I Switch 

+. 

I 

+. 


+... 

I Format | Meaning 

+... 

Individual Switches 

+.+. 


Name 

1 /NA 

1 

I Lists file name only. 

i 

Type 

1 /TY or 

i Lists file name and type. 

1 

Extension 

i /EX 

I 

Size 

1 

1 /SZ or. 

! /SI 

i 

i 

1 

1 

1 

1 

1 

1 

i Lists file name, type, size (in blocks) 

; of each file. DIRECT lists a C if file 
i is contiguous, P if file is protected 
! (nondeletable) , and L if file is 

| located (placed). The /SI switch cannot 

1 immediately follow the DIRECT CCL 
| command. For example, assuming the 
| DIRECT CCL command is DIR, you cannot 
| type DIR/SI; however, you can type 
| DIR/SZ. 
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Table 2-3: DIRECT Switches (Cont.) 

....+.*.. 

| Switch | Format | Meaning I 

..... ..+ 

j Individual Switches I 

+ . + ... + 


Allocated 

1 

1 /AL 

1 

1 

1 

i 

1 

1 

1 

1 

1 

| Lists file name, type, and number of 
| blocks allocated to the file. The 
i number of blocks listed is always a 
| multiple of the cluster size. For 
| example, if the cluster size is 4 
| blocks and the actual file size is 5 
| blocks, the allocation is listed as 8 

| blocks. 

| 

Open status 

/OP 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

| Lists file name, type, open status, and 
| access count. DIRECT appends a U to the 

I access count if the file is currently 
| open in UPDATE mode, and a W if the 
i file allows others write access. 

1 DIRECT lists the access count as two 
| numbers separated by a slash (/). The 
| first number indicates the number of 
i users who currently have the file open 
| in any mode except read regardless 
| mode. The second number indicates the 
| number of users who currently have the 

j file open in read regardless mode. 

1 

Run-time 

1 /RT 

1 

| Lists the name of the run-time system 

| that created the file. 

1 

Protection 

1 /PR 

1 

1 

1 

| Lists the file name, type, and file 
| protection-. 

1 

Last access 

1 /LA 

1 

! 

1 

| Lists the file name, type, and date of 
j last access or update, depending on 
j disk initialization. 

Date 

1 /DA 

1 

1 

1 

| Lists the file name, type, and date of 
| creation. 

I 

Time 

1 /TI 

1 

1 

| Lists file name, type, date and time of 

| day of creation. 

1 

Cluster size 

1 /CL 

1 

1 

| Lists file name, type, and cluster 
j size. 
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Table 2-3: DIRECT Switches (Cont.) 


+ 

1 

1 

+ 

Switch 

| Format | 

Meaning 

1 







1 

+ 



Individual Switches 

1 

1 


| 

1 



1 

Summary 

1 /su 

1 

1 

Lists summary data only to include 

1 

1 

i 


1 

1 

number of designated files and total 

1 

! 



1 

number of blocks occupied by designated 

1 

1 

1 


1 

1 

1 

1 

files. 

1 

i 

Position 

1 /PO 

1 

1 

Lists file name, type, and position of 

1 

1 

1 


1 

i 

the file on disk (the device cluster 

| 

1 


1 

1 

number of the file's first block). See 

1 

1 

1 


1 

1 

1 

1 

the RSTS/E System User's Guide. 

1 

i 

Symbolic attribute 

1 /SA 

1 

or | 

Lists file name, type, symbolic file 

1 

1 

Attribute 

1 /AT 

i 

attributes, and caching status. File 

i 

1 


1 

i 

caching is indicated by one of the 

i 

! 


1 

i 

following: 

i 

i 


1 

! 

CACHE:ON:RAN ; automatically cached 

i 

l 


1 

i 

randomly when open 

i 

1 


1 

i 

CACHE:ON:SEQ; automatically cached 

i 

l 


1 

1 

sequentially when open 

i 

! 


| 

1 

1 

CACHE:OFF:SEQ; not automatically 

! 

i 

i 


l 


cached, but if cached, 

i 

1 


1 

1 

1 

it is cached 

1 

1 

I 


i 

| 

i 

1 

sequentially. 

1 

1 

1 

Octal attribute 

1 /OA 

i 

1 

Lists file name, type, and a series of 

1 

! 

1 


1 

1 

octal numbers that represent file 

1 

1 

+ - 


1 

1 

attributes. 

1 

i 

+ - 



Aggregate Switches 

+ 

1 

| 


| 



+ 

! 

Brief 

1 /BR 

1 

or | 

Lists file name and type and a brief 

1 

I 

i 

i 

Fast 

1 /F 
| 

i 

l 

ending summary message. 

1 

1 

1 

i 

Full 

1 /FU 

i 

i 

Lists heading, file name, type, size, 

1 

1 

i 


1 


protection code, date of last access, 

1 

i 


1 

i 

date of creation, time of creation, 

i 

i 


1 

i 

cluster size, associated run-time 

1 

! 


1 

i 

system, file position, open status, and 

1 

i 


1 

i 

an ending summary message. 

1 
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Table 2-3: DIRECT Switches (Cont.) 


j Switch 

+. 

+. 

i Directory,slow 
; Listing,slow 
! Slow 




| Directory 
| Listing 
| Carriage return 


+.+. 

| Format | Meaning 


Aggregate Switches 

+.+. 


/DI:S or 
/LI:S or 
/S 


/DI or 
/LI or 
<RET> 


i Lists all relevant data to include 
| heading, file name, type, size, 

| protection code, date of last access, 

| date of creation, time of creation, 

I cluster size, associated run-time 
i system, file position, symbolic 
| attributes, open status (if possible to 
| display on the same line), files marked 
| for deletion (see /MD), and an ending 
| summary message. 

j 

I Lists most important data to include 
! heading, file name, type, size, 

| protection code, creation date, and an 
| ending summary message. 


+ 

I 

+ 

I 

+ 


i Marked for 
I deletion 

I 

i 


| No match 

| 

i 

+. 


+ 


/MD 


/N 


+ 


| Lists all files, and flags those files | 

| marked for deletion by appending an * | 

j character after the file name. . j 

i Tentative files are marked for deletion | 

| until closed. | 

i j 

| Lists only those entries that do not | 
j match the specified input file j 

| specification. | 

-- +. .. + 

General Switches | 

- - +..- - .....+ 


i Heading 

I 

i 


Wide 


/HD 


/W 


Displays heading at top of columns in 
the listing for those listings that 
normally do not include a heading, if 
you specify /HD without another switch, 
DIRECT displays an error message. 

Lists data across the width of a line 
rather than one item per line. Useful 
with large directory listings and 
individual switches. When used alone, 

/W lists file names and types across 
the width of a line and an ending 
Summary message. 
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Table 2-3: DIRECT Switches (Cont.) 


Switch j Format | Meaning 


General Switches 


Help 

1 

1 /HE 

i 

1 

Displays the DIRECT.HLP file, which 

Backwards 

1 

1 

1 /BK 

1 

1 

1 

describes the DIRECT program. 

Lists the directory for the specified 


I 

1 

1 

1 

i 

1 

1 

1 

1 

1 

device in reverse order. As a result, 
the files at the end of the directory 
appear at the beginning of the listing. | 
If you use /BK to list files in the | 

public structure and the public 


1 

1 

1 

1 

i 

1 

1 

1 

1 

structure includes multiple disks, the | 
listing reflects reverse order for each | 
disk. DIRECT cannot list directories in | 
reverse order if the directory contains | 
more than 200 files. 


DIRECT Examples 


Consider the following example: 

$ RUN SDIRECT 


DIRECT V9.0 RSTS V9.0 
# /DI:S 


Name .Typ 
SY:[2,106] 

Size 

Prot 

Access 

MAIL 

.MAI 

4 

<188> 

13-Jun-85 

RF:FIX=512 

FO:SEQ 

USED: 

5:0 

EX: 1 

SPR2 

.OBJ 

3 

< 60> 

09-Apr - 85 

RF:VAR-128 

FO:SEQ 

USED: 

3:44 

MAIL 

.SYS 

14 

< 60> 

08-May-85 

FLINT .LOG 

5 

< 60> 

09-Apr - 85 

BLDQUE.LOG 

24 

< 60> 

13-Jun-85 

BRIAN .NAD 

1 

< 60> 

15-Jan-85 

SNOOP .CMD 

1 

< 60> 

15-Jan-85 


Date 

Time 

Clu 

RTS 

Pos 

Op/rr 

13-Jun-85 
RECSI:512 

09:53 

AM 

4 

...RSX 

1090 

0/0 

09-Apr-85 
RECSI:122 

08:31 AM 

CC:IMP 

4 

...RSX 

677 

0/0 

08-May-85 

09:05 

AM 

4 

...RSX 

6447 

0/0 

09-Apr - 85 

02:34 

PM 

4 

...RSX 

8613 

0/0 

13-Jun-85 

09:55 

PM 

4 

BAS4F 

4955 

0/0 

15-Jan-85 

09:54 

AM 

4 

TECO 

13529 

0/0 

15-Jan-85 

11:15 

AM 

4 

RTll 

3386 

0/0 


Total of 52 blocks in 7 files in SY:[2,106] 
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In this example, you run the DIRECT program and select the /DI:S 
switch. DIRECT lists all relevant information for all files that 
reside on the system disk in your account. DIRECT then reports these 
items: 

Name.Typ File name and type 


Size 

Size (in blocks) of each file 

Prot 

Protection code 

Access 

Date of last access 

Date 

Date of creation 

Time 

Time of creation 

Clu 

File cluster size 

RTS 

File's run-time system 

Pos 

Position of the file on disk (the device cluster number of 
the file's first block) 

Op/rr 

The number of times the file is currently open in any mode 
except read regardless (Op); and the number of times the 
file is currently open in read regardless mode (rr) 


Immediately below the headings, DIRECT lists the disk location of the 
files and the user's PPN. 

Some files in this example have additional descriptive data listed on 
the line following the file data. This data-lists ‘the file 
attributes, which are required by RMS-11 software. For the meaning of 
the listed attributes, see the section "File Attributes." 

Several of the listings that DIRECT produces contain only one or two 
columns. By default, DIRECT outputs columns in a vertical format. In 
these cases, you can use the /W switch and obtain a listing that spans 
the width of your terminal or paper, if you print the listing. For 
example: 

#LP0:»*.BA7/F/W 
SY:[3,214] 

NONAME.BAS ESC .BAS SYS6 .BAS RESCUE.BAS FIPI6 .BAS RBLOCK.BAS 

NUMBER.BAS WBLOCK.BAS TD .BAS SWAP .BAS INDEX .BAS 


11 Files 36 Blocks 
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In this example, DIRECT outputs the listing to line printer LPO. The 
listing includes the file name and type of all files in your current 
account having BA as the first two characters in the file type. 

DIRECT formats the listing into six columns. The listing ends with a 
summary statement showing the number of files and their total size in 
blocks. 

Several of the listings that DIRECT produces do not include column 
headers. In these cases, you can obtain column headers by using the 
/HD switch. Repeating the previous listing, but including the /HD 
switch, you obtain the following listing: 

#LP0:«*.BA?/F/W/HD 

Name .Typ Name .Typ Name .Typ Name .Typ Name .Typ Name .Typ 

SY:[3,214 ] 

NONAME.BAS ESC .BAS .SYS6 .BAS RESCUE.BAS FIP16 .BAS RBLOCK.BAS 

NUMBER.BAS WBLOCK.BAS TD .BAS SWAP .BAS INDEX .BAS 

If you specify the /HD switch but do not also include another switch, 
DIRECT displays this error message: 

?/HD illegal without other switches 

You can list the directory of an account other than your own by 
specifying the PPN field in the command line. However, DIRECT limits 
your listing to those files whose protection codes permit read, write, 
or execute access by your account. For example: 

# PROJ*[120,3]/DI:S 

DIRECT creates the file PROJ.DIR in your current account and writes 
all relevant data to the file for all files in account [120,3] for 
which you have read, write, or execute access. For more information 
about protection codes, see the RSTS/E System User's Guide. 


DIRECT as a CCL Command 

Your system manager can install a CCL command for DIRECT on your 
system. When you run DIRECT with a CCL command, you enter the program 
at the command level. DIRECT does not display an identifying header 
or a # prompt. Therefore, you must include DIRECT command line 
specifications in the CCL command line. For example: 

$ CCL DIR LP1:-*.BAS 

In this example, DIRECT lists the file name, type, size, protection 
code and creation date of all BASIC-PLUS source files (.BAS) on line 
printer LPl. 
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When you run DIRECT with a CCL command, the defaults remain the same 
as when you specify RUN SDIRECT. Output defaults to your terminal, 
input defaults to all files in your user's account, and the switch 
defaults to /DI. 


File Attributes 

File attributes are file description data that RMS-11 software 
requires. For instance, both COBOL and BASIC-PLUS-2 use RMS-11. The 
User File Directory (UFD) for a given file contains the file 
attributes for that file. Some of the more important file attributes 
are: 


o 

o 

o 

o 

o 

You can 
o 

o 


File organization 
Record type 
Record size 
File size 

Location of the next free byte within the file 
list file attributes in two formats: 

Symbolically, using the /SA, /AT, and /S switches 
Octally, using the /OA switch 


The following example shows the use of the /SA switch to obtain file 
attributes in a symbolic format: 

#/SA/HD 




Name .Typ 
SY:[2,211] 

RMSTST.OBJ 
RF:VAR-128 FO:SEQ 
PFILE .DAT 
RF:FIX-56 FO:IDX 
CHTSTl.OBJ 
RF:VAR-128 FO:SEQ 
RMSTST.B2S 
PROOF .BAS 
RDPLN1.DOC 


USED:7:22 
USED:8:0 
USED:2:396 


RECSI:128 
RECSI:56 
RECSI:90 


CC:IMP 
CC:IMP 
CC:IMP 
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Table 2-4 lists the symbolic file attribute descriptions 
Table 2-4: Symbolic Attribute Fields 
....*__ 


I Attribute | 

+.. 


Meaning | Descripti 


- - - + 


ion 


RF 


FO 


USED 


RECSI 


CC 


NOSPAN 


BK 


| EX 


| HS 


Record format 


File 

organization 


Blocks in use 


Record size 


Carriage 

control 


No span 


Bucket size 


Extension 


Header size 


| Displays the maximum record length of 
I the file. The possible formats are: 

o UDF - - undefined 
I o FIX -- fixed 

I o VAR -- variable 

o VFC -- variable /fixed control 

o STM - - stream 

Displays type of file organization: 
o SEQ -- sequential 
o REL - - relative 
o IDX -- indexed 

Displays the number of blocks 
currently in use, followed by the 
number of bytes used in the last 
block. 

Displays the size, in bytes, of the 
largest file record. 

Displays the type of carriage control: 
o IMP - - implied 
O FOR - - FORTRAN 

If displayed, indicates that records 
are not allowed to span block 
boundaries. 

Displayed if the file organization is 
relative or indexed; indicates the 
bucket size in blocks. 

If you do not use the default, 
indicates the number of blocks added 
to the file each time you increase its 
size. 

If you do not use the default, 
indicates the fixed header size. 
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An octal format file attribute listing normally consists of seven 
6-digit words. A listing of file attributes for RMS-created files, 
however, consists of nine or ten words. The additional words contain 
information required by RMS-11. 

The following example shows the use of the /OA switch to obtain an 
octal format file attributes listing. Following the listing is the 
annotation describing the octal file attributes for file FILE.DAT. 

#/OA/HD 


Name .Typ 
SY:(2,211] 

FILE .DAT 7 < 60> 13-Jun-85 13-Jun-85 02:10 PM 8 RSX 0 

001041 000070 000000 000010 000000 000007 000000 000001 000070 000010 
RMSTST.OBJ 

001002 000200 000000 000007 000000 000007 000026 000000 000200 
RMSTST.MAP 

000002 000167 000000 000211 000000 000211 000354 
PFILE .DAT 

001041 000070 000000 000007 000000 000010 000000 000001 000070 
RMSTST.B2S 
RMSTST.CMD 
RMSTST. ODL 
PROOF .BAS 

Annotation for file FILE.DAT: 


The first word, 001041, indicates: 

000001 -- The file has fixed length records 
000040 -- The file has indexed organization 
001000 -- Carriage control is implied 

The second word, 000070, indicates that the number of bytes in each 
record is 70 octal (56 decimal). 

The third and fourth words, 000000 and 000010, indicate that the file 
size is 10 octal blocks (8 decimal). 

The fifth and sixth words, 000000 and 000007, indicate that the first 
7 blocks in the file are in use. 

The seventh word, 000000, indicates that no bytes are in use in the 
seventh block. 

The eighth word, 000001 (00000000 00000001 binary), indicates that the 
bucket size is 1 block and the fixed header length is 2 bytes. 

The ninth word, 000070, indicates that the record size is 70 octal 
bytes (56 decimal). 
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The tenth word, 000010, indicates that the file is allocated 10 
additional blocks (8 decimal) each time it is extended. 

Table 2-5 lists the ten words and their meanings. 

Table 2-5: Octal File Attributes 


.+ ■ 

Word | 
.+ • 


Meaning 


• + 

I 

• + 


3 and 4 

5 and 6 


Low order digit 
000000 
000001 
000002 
000003 
000004 


Record format 
undefined 

fixed length records 
variable length records 
variable with fixed control 
stream format records 


Second digit - 
000000 - 
000020 - 
000040 - 


- File organization 

- sequential organization 

- relative organization 

- indexed organization 


Third and fourth digits - 

000400 - 
001000 - 
004000 - 


- Record attributes 

- FORTRAN carriage control 

- implied carriage control 

- no span 


Fifth and sixth digits -- Not used 

The size in bytes for fixed-length records or the size 
of the largest record for variable-length records. 

A two-word integer that represents the file size. Word 
is high order; word 4 is low order. 

A two-word integer that represents the number of blocks 
that are currently in use for data. Word 5 is high 
order; word 6 is low order. Note that words 3 and 5 are 
nonzero only if the file is larger than 65535 blocks. 

The number of bytes in use for the last block used. The 
size of a file with n full blocks can be described as n 
blocks with 512 characters in the last block or as n+1 
blocks with 0 characters in the last block. 
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Table 2*5: Octal File Attributes (Cont.) 


Word 


Meaning 



In binary notation, the bytes are: 
Low byte 


High byte 


The bucket size, in blocks, in the range 
1 to 32. If this byte is 0, the bucket 
size is 1 block. 

The fixed header size, in bytes, in the 
range 1 to 255. If this byte is 0, the 
header size is 2 bytes. 


The maximum record size in bytes. If the file contains 
fixed-length records, this word contains the record 
length. If this word is 0, no maximum size is set for 
the file. 

The number of blocks to which the file is extended by 
default. The content of this word represents the number 
of blocks added to the file each time it is extended. 


Both RMS-11, and all languages that use RMS-11, process file attribute 
data. BASIC-PLUS and FORTRAN IV do not use RMS-11 and, therefore, do 
not correctly process files that have attributes. You cannot use 
programs written in BASIC-PLUS or FORTRAN IV with files produced by 
RMS-11 unless they are specially programmed to handle file attributes. 
FORTRAN-77 uses file attributes but does not use RMS-11. 

PIP is the only generally used program that preserves file attributes 
and run-time systems in disk-to-disk transfers within one system. 

When PIP copies a disk file to a nondisk device, the program performs 
file format conversions, either automatically, or as you specify with 
switches. PIP can also perform file format conversions when copying 
from a nondisk device to a disk file, creating the appropriate file 
attributes in the process. 

When moving files between systems using magnetic tape as the 
transportation medium, you have two alternatives: 

o Use the RSTS/E BACKUP or PIP programs for transfers between 
two RSTS/E systems. 

o When the copied files are RMS-11 files and the transfer is 
between a RSTS/E system and a system in the RSX-11 family, 
use the RMS BACKUP package. 
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See the RSTS/E RMS-11 User's Guide for more information about RMS-11 
and file attributes. 


DIRECT Error Messages 

When DIRECT finds an error in a command, the program displays an error 
message followed by the # prompt. You must then retype the entire 
command correctly. 

Table 2-6 lists the DIRECT error messages and their meanings. 

Table 2*6: DIRECT Error Messages 

+ . + 

| Message and Meaning | 

+ .. + 

| ?DECTAPE ERROR <text> | 

j An error occurred while processing the DECtape. j 

I I 

| ’DEVICE NOT DIRECTORY STRUCTURED | 

j Device specified does not use a directory for file access. j 

| ’DIRECTORY OF dev:[n,m] IS EMPTY 

j The account [n,m] on device dev: contains no entries. j 

I I 

| ?DISK PACK IS NOT ON-LINE | 

j Either the pack or cartridge you specified is not mounted or it | 
j is off-line. j 

| 7DISK PACK IS RESTRICTED 

j The device is restricted (SET DEVICE/RESTRICTED) and you lack | 

the DEVICE privilege. 

j ?/HD illegal without other switches. j 

j When you specify /HD, you must also specify another switch. | 

I I 

| ’ILLEGAL FILE NAME <filename> | 

j The file specified by <filename> contains a logical device name j 

j which you have not reserved by the ASSIGN command. | 

I I 

| ’ILLEGAL INPUT FILE SPEC <file spec> | 

The file specification indicated by <file spec> generates the j 
error ?Illegal file name. j 

I I 

| ?ILLEGAL SWITCH text | 

j The file specification contains an undefined switch as j 

j indicated by text. | 
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Table 2-6: DIRECT Error Messages (Cont.) 


Message and Meaning 


’INVALID DEVICE SPECIFICATION 

Either the specified device is invalid or the device does not 
exist on the system. 

?MAGTAPE ERROR <text> 

An error occurred while processing the magnetic tape. 

’MAGTAPE IS NON-FILE STRUCTURED 

RSTS/E does not understand the tape format. 

?NO DIRECTORY FOR [n,m] ON dev: 

DIRECT cannot find an account for user account [n,m] on the 
device dev: or else DIRECT encounters a protection violation. 

’NO HELP AVAILABLE 

The file DIRECT.HLP is not in the system library account. 

?N0 SUCH FILE AS <file spec> ON [n,m] 

DIRECT cannot find the requested file indicated by <file spec> 
in the account [n,m]. 

’OUTPUT FILE MUST BE IN THE USER'S AREA 

DIRECT does not create an output disk file in another account 
if you do not have the necessary privilege. 

?OUTPUT MUST BE FILE STRUCTURED <filename> 

The output device must be file structured; for example, a 
mounted disk. 

’UNABLE TO CREATE OUTPUT FILE <filename> 

The device may be write protected or there is not enough space 
in the directory of the account. 

’TOO MANY FILES FOR INVERTED DIRECTORY LISTING 

DIRECT limits use of the /BK switch to accounts with fewer than 
200 files. 

+... 
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Comparing Files: The FILCOM Program 

The FILCOM (File Compare) program compares two ASCII files, line by 
line, and identifies differences. When you run FILCOM you specify the 
files you want to compare and (optionally) one or more switches that 
direct the comparison. 


Privilege Required 

To run FILCOM, you need the following: 

o Read access to the files you want to compare 
o Create/Rename access for any output file you create 


Running FILCOM 
To run FILCOM, type: 

$ RUN SFILCOM 

FILCOM then displays this two line identification header: 

FILCOM V9.0 RSTS V9.0 

File Comparison Program 13-Jun-85 11:59PM 
Following the identification header, FILCOM displays the prompt: 

Output to <KB:>? 

In answer to the prompt, you can type one of three responses: 

o The device designator or a RSTS/E file specification to which 
FILCOM writes the comparison data. 

If you specify only a device, a RSTS/E file specification, or 
press RETURN to accept the user terminal as a default, FILCOM 
displays additional prompts. These prompts request the files 
you want to compare and let you set the parameters of the 
comparison. The next section describes the prompts. In 
answer to this prompt, you can specify one or more switches 
listed in Table 2-7. These switches provide an alternative 
method for specifying comparison parameters. 
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o A single command line that contains all of the information 
that FILCOM needs to make the file comparison. The command 
line has the format: 

[output*]inputl,input2[/sw] 

If you specify the full command line, FILCOM does not display 
other prompts and begins the file comparison. Use of the 
command line allows you to specify wildcards in the file 
specifications and to specify one or more optional switches. 
The section "FILCOM Single Command Line" describes the 
command line specification and Table 2-7 describes the FILCOM 
switches. 

o A command line that contains a DCL command file name. The 
DCL command file is an ASCII text file you create with PIP or 
an editor. See the RSTS/E Guide to Writing Command 
Procedures. The file must contain all the information FILCOM 
needs to make the file comparison. The command line has the 
format: 

Output to <KB:>? @file name 

File name is the name of a DCL command file. The DCL command 
file can contain a single line command as described in the 
previous response, or it can contain multiple line answers to 
the FILCOM prompts as described in the first response. If 
the DCL command file contains answers to the FILCOM prompts, 
you must answer each prompt in sequence as described in the 
section "FILCOM Prompts." You cannot nest another DCL command 
file within the original response. If FILCOM finds an at 
sign (@) character in the DCL command file, the program 
processes it as an assignable account" specification. 

After FILCOM completes a file comparison, the program returns to the 
Output to <KB:>? prompt for additional input. To exit from FILCOM, 
enter CTRL/Z in response to the prompt. 


FILCOM Prompts 

If you answer the initial FILCOM prompt with a device designator or a 
RETURN, FILCOM displays a series of additional prompts. These prompts 
request the following information: 

o The files you want to compare 

o The number of successive lines in those files that constitute 
a match 
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o Whether FILCOM considers BASIC-PLUS continuation lines as 
part of a numbered line 

o Whether FILCOM compares blank lines 

You can specify one or more switches in response to FILCOM's initial 
prompt. You can use a switch specification to override prompt 
displays and to provide additional instructions to the FILCOM program. 

Following the initial prompt, FILCOM displays prompts for the file 
names of the ASCII files you want to compare. For example: 

Output to <KB:> ? <RET> 

Input File #1? SORT1.BAS 
Input File #2? S0RT2.BAS 

In this example, FILCOM compares SORTl.BAS to SORT2.BAS and displays 
the result of the comparison on your terminal. Include the file type 
when you specify the files you want to compare. You can use the * and 
? wildcard characters to designate the input files. See the section 
"Wildcards" for information on their use. 

The How Many to Match <3>? prompt asks for the number of lines that 
FILCOM considers a match. As FILCOM compares the lines in a file, it 
displays the differences until it comes to a series of lines that are 
identical. Your answer to this prompt determines the number of lines. 
For example: 

Output to <KB:>? SORT.DIF 
Input File #1? SORTl.BAS 
Input File #2? SORT2.BAS 
How Many to Match <3>? <RET> 

In this example, you create a file named SORT.DIF that contains the 
results of the comparison between files SORTl.BAS and SORT2.BAS. 

FILCOM examines the files and records the differences until it finds 
three lines that match. To accept the default of three lines, press 
the RETURN key. 

Following the How Many to Match <3>? prompt, FILCOM asks if you want 
to consider BASIC-PLUS continuation lines as part of a numbered 
program line. For example: 

Output to <KB:>? <RET> 

Input File #1? SORTl.BAS 
Input File #2? S0RT2.BAS 
How Many to Match <3>? <RET> 

BASIC+ Lines <N0>? Y 

In this example, FILCOM considers continuation lines as part of a 
numbered program line when it compares SORTl.BAS and SORT2.BAS. The 
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default for this prompt, <NO>, causes FILCOM to compare only single 
lines. 

Consider the following program line: 

100 FOR J%=1% TO 15 & 

\ PRINT 3.14*J%/2. & 

\ NEXT J% 

If you answer the BASIC+ Lines <NO>? prompt with Y (for YES), FILCOM 
compares all three multiline statements (FOR, PRINT, and NEXT) as a 
single line. If you accept the NO default, FILCOM only compares the 
first line (FOR J%-1% TO 15% &) in SORTl to a single line in SORT2. 

The last prompt in the series asks if you want to compare blank lines. 
For example: 

Output to <KB:>? SORT.DIF 
Input File #1? SORTl.BAS 
Input File #2? SORT2.BAS 
How Many to Match <3>? 5 
BASIC+ Lines <NO>? Y 
Blank Lines <NO>? <RET> 

In this example, FILCOM compares SORTl.BAS to SORT2.BAS and writes the 
differences to SORT.DIF. FILCOM matches five successive lines, 
considers BASIC-PLUS continuation lines, and ignores the presence of 
blank lines. If FILCOM finds two blank lines in SORTl and five blank 
lines in SORT2, it does not consider this a difference. See the 
section "FILCOM Examples" for examples of FILCOM comparisons. 


FILCOM Single Command Line 

In response to FILCOM's initial prompt, you can type a single command 
line that specifies all files and comparison parameters. This command 
line has the format: 

(output-]inputl,input2[/switch] 
where: 

output is one of the following: 

o A complete RSTS/E file specification containing 
device, ppn , file name, and type designators. 

o A RETURN key that specifies the default user 
terminal. If you press RETURN, FILCOM displays 
prompts. See the section "FILCOM Prompts." 
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° * wildcard specification (see the section 

"Wildcards"). 


o No specification. If you do not specify a file 
or “ symbol but rather an input specification 
only, FILCOM displays its output on your 
terminal. 


specifies an output file. if you type an = symbol with 
no output specification, FILCOM writes the result of 

filc™ ^!!f par ^° n * £ile on the P ublic structure. 

filf neml e f tbls £l J e ln the current account using a 
taken f rom the first input file and using a 
.DiF file type. 

inputl, 

input2 

names the two files that FILCOM compares, separated 
oy a comma. You can describe these files with full file 

,f ile names and types, or wildcards (see 
the section "Wildcards"). 

/switch 

names one or more optional switches. 

See the section 
command line. 

"FILCOM Examples" for examples of the FILCOM single 


FILCOM Switches 


You can specify one or 
response to the FILCOM 


more switches in the FILCOM command 
prompts. 


line 


or 


in 


Table 2-7 lists the FILCOM switches and their meanings. 
Table 2-7: FILCOM Switches 


. . + .. 

I Switch | Format | 
+...+ 


Meaning 


Match 


/MA[:n] 


Specifies the number of lines in the file 
that constitute a match (see the section 
FILCOM Prompts"). If you do not specify 
the number of lines (n), the default is 
three. 


- + 

I 

■ + 


Blank, | /BL, 

No blank | /NOBL 


Specifies whether FILCOM considers blank 
lines in its comparison (see the section 
"FILCOM Prompts"). The default is not to 
consider blank lines (/NOBL). 
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Table 2-7: FILCOM Switches (Cont.) 


Switch | Format 


Meaning 


BASIC, 

No BASIC 


/BA, 

/NOBA 


Patch 


/PA 


Append 


/AP 


Summary 


Limit 


/SU 


/Lit:n] 


Compare 


/CO[:m:n] 


Specifies whether FILCOM considers 
BASIC-PLUS continuation lines as part of a 
numbered program line (see the section 
"FILCOM Prompts"). The default is not to 
consider continuation lines (/NOBA). 

Directs FILCOM to.create the output file as 
a patch file. You can use a BASIC-PLUS 
APPEND command (see the RSTS/E BASIC-PLUS 
Language Manual) to include the patch file 
in a succeeding FILCOM operation to cause 
the resulting output to be equivalent to 
the second input file. 

Directs FILCOM to open the output file for 
APPEND (see /PA switch). If you omit this 
switch, FILCOM deletes any existing output 
file of the same name before writing 
differences. With the /AP switch, you can 
direct FILCOM to write differences into an 
existing output file. 

Directs FILCOM to list the total number of 
differences found in the files without 
listing individual lines. 

Specifies the maximum number of lines that 
are allowed to differ before FILCOM stops 
examining the file. If you include the 
/LIMIT switch but do not specify a limit in 
n, the default is 60 differing lines. 

Converts tabs to the appropriate number of 
spaces and directs FILCOM to compare 
characters starting in column position m 
and continuing for n characters. If you 
include the /COMPARE switch but do not 
specify m or n, FILCOM defaults m to column 
position 1 and n to 72 characters. 


Use of these switches is not restricted to single line commands. You 
can specify any of these switches in answer to the Odtput to <KB:>? 
prompt, regardless of whether you specify the full FILCOM command line 
in that prompt. 
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If you do not specify any switches, FILCOM assumes that three lines 
are a match: that is, FILCOM does not compare blank lines and does not 
consider BASIC-PLUS continuation lines as part of a numbered program 
line (/MA:3/NOBL/NOBA). However, if you specify the /PA switch, 

FILCOM compares blank lines and considers BASIC-PLUS continuation 

lines. A /PA specification overrides the normal defaults and sets /BA 
ana /BL. 


f pecify 3 sw i tc h i- n illegal format or a switch that is not one 
of the legal set, FILCOM displays the error message: 

?Illegal command line /x 

In this error message, /x refers to the illegal switch. 

y° u specify the / LI switch, FILCOM ceases to compare the files when 
it finds a set number of differing lines during a single comparison. 
You can specify the number in the switch or accept the default of 60 
lines. Once the limit is exceeded, FILCOM stops comparing the files 
and displays the error message: 

?Limit (x) reached on last compare, skipping rest of file 

In this message, (x) refers to the /LI specification or the default of 
60. FILCOM sets no limit unless you specify the /LI switch. 

You can use the /CO switch to direct FILCOM to ignore characters 
beyond a certain column. For example, suppose you want to compare a 
program that contains comments beginning in column 80. Specify 
/CO:1:79 in the command line to cause FILCOM to convert all tabs to an 
equivalent number of spaces (in order to properly count character 
positions) and to compare each line from column 1 to column 79. 

FILCOM ignores everything after column 79. 


Consider the following examples: 


Output to <KB:>? SORT.DIF=SORTl.BAS,SORT2.BAS 


FILCOM compares SORT1 and SORT2 and writes the differences to file 
SORT.DIF. FILCOM sets the /MA:3, /NOBA, and /NOBL switches by 
default. 


Output to <KB:> ? « SORT1.BAS,SORT2.BAS/LI:10 

FILCOM compares SORT1 and SORT2 until either the number of differing 
lines in a single comparison exceeds 10 or the comparison is complete. 
FILCOM creates a file named SORT1.DIF in the current account to store 
the results of the comparison. FILCOM sets the /MA:3, /NOBA, and 
/NOBL switches by default. 
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Output to <KB:>? SORTl.BAS,SORT2.BAS/BA/BL/SU 

FILCOM compares SORTl and SORT2 and displays a summary of the 
differences on your terminal. FILCOM compares blank lines (/BL) and 
considers BASIC-PLUS continuation lines (/BA). 


Wildcards 


You can include wildcard characters in both the output and input file 
specifications in a FILCOM command line. The * wildcard replaces an 
entire specification field. The ? wildcard replaces a single 
character within a field. 

FILCOM output file specifications can contain a wildcard for the file 
name or type, but not both. For output, you must specify a file name 
or type, or default both fields (see the section "FILCOM Single 
Command Line"). 


You can specify FILCOM input files using full RSTS/E file 
specifications or using wildcard characters. When you include 
wildcards in a FILCOM command line, FILCOM bases its search for files 
on the first input file specification. 


FILCOM uses wildcard specifications for input files in the following 
manner: 

Specification Action by FILCOM 

*.TYP,*.XYZ Compares all files with the type .TYP and 

all files with the same file names and 
type .XYZ. 


ABC.*,DEF.* 

[5.30] *.*,[5,31]*.* 

[5.30] *.*,[5,31]*.TYP 

AFILE?.*,BFILE?.* 


Compares all files named ABC with any file 
type and all files named DEF with the same 
types. 

Compares all files in account [5,30] and 
all files with the same file names and 
types in account [5,31]. 

Compares all files in account [5,30] -and 
all files, with the same file names and a 
.TYP type in account [5,31]. 

Compares all files whose file name consists 
of AFILE and any character with any type and 
all files whose file name consists of BFILE, 
the same character, and the same file type. 
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Action by FILCOM 

Compares all files with the type .ABC and 
all files of the same file name with the 
type .DEF. As FILCOM compares each set of 
files, it creates a series of output files 
with the type .DIF. The output file names 
duplicate the file names of each .ABC 
file compared. 

to make multiple file comparisons based on a 
single command line specification. When you make multiple 
comparisons, FILCOM displays the differences found in each set of 
files in the standard manner (see the section "FILCOM Examples"). In 
addition, FILCOM displays a summary at the completion of the 
comparisons. The summary has the format: 

?x Differences Found in y Files of z Total Files Compared 
where: 

x is the total number of differences in all files 

y is the number of files that contain differences 

z is the total number of files compared based on the 

wildcard specification 

You can specify wildcard file names only for the first input file if 
the file resides on disk. If the first input file is not a disk file, 
FILCOM displays the following error message: ' 

?Wildcard filename illegal on device x 

In this error message, x refers to the specified input device. FILCOM 
then returns to the Output to <KB:>? prompt. The second input file 
does not have to reside on disk. 

If a wildcard specification causes FILCOM to create an output file 
name that is syntactically incorrect, (one containing embedded spaces, 
for example) FILCOM displays the following error message: 

?Illegal filename x created from y by z 

where: 

x is the illegal file name 

y is the first input file wildcard specification you typed 

z is the file specification for the second input file 


Specification 
*.DIF-*.ABC,*.DEF 


You can use wildcards 
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If you specify a wildcard character for both the file name and type 
for th*e output file, FILCOM displays the following error message: 

?Wildcard x illegal for output filename 

In this error message, x refers to the illegal wildcard specification. 


FILCOM Examples 

Assume that the following two files are in your account on the system 
disk. 

TEST1 TEST2 


10 

REM 

A 

10 

REM 

A 

20 

REM 

B 

20 

REM 

B 

30 

REM 

C 

30 

REM 

C 

40 

REM 

D 

70 

REM 

G 

50 

REM 

E 

80 

REM 

H 

60 

REM 

F 

90 

REM 

I 

70 

REM 

G 

100 

REM 

J 

80 

REM 

H 

110 

REM 

1 

90 

REM 

I 

120 

REM 

2 

100 

REM 

J 

130 

REM 

3 

110 

REM 

K 

140 

REM 

N 

120 

REM 

L 

150 

REM 

O 

130 

REM 

M 

160 

REM 

P 

140 

REM 

N 

170 

REM 

Q 

150 

REM 

O 

180 

REM 

R 

160 

REM 

P 

190 

REM 

S 

170 

REM 

Q 

200 

REM 

T 

180 

REM 

R 

210 

REM 

U 

190 

REM 

S 

220 

REM 

V 

200 

REM 

T 

222 

REM 

4 

210 

REM 

U 

224 

REM 

5 

220 

REM 

V 

230 

REM 

W 

230 

REM 

W 

240 

REM 

X 

240 

REM 

X 

250 

REM 

Y 

250 

REM 

Y 

260 

REM 

Z 

260 

REM 

Z 





To compare these files, you can run FILCOM as follows: 
$ RUN $FILCOM 

FILCOM File Comparison Program 13-Jun-85 11:14 AM 

Output to <KB:>? TEST1.BAS,TEST2.BAS 
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Hof* Un ! ? irects the FILCOM output to your terminal and 

follows^ 6 SWltCheS /MA:3 ' /N0BL ' and /NOBA. The output appears as 

COMPARING: 1) [2,211]TESTl.BAS TO 2) [2,211]TEST2.BAS 

****************************** 

1) [2,211]TESTl.BAS 
40 REM D 

50 REM E 
60 REM F 
70 REM G 
********** 

2) [2,211]TEST2.BAS 
70 REM G 

************************** * * * * 

1) [2,211]TESTl.BAS 
110 REM K 

120 REM L 
130 REM M 
140 REM N 
********** 

2) [2,211]TEST2.BAS 
110 REM 1 

120 REM 2 
130 REM 3 
140 REM N 

****************************** 

1) [2,211]TESTl.BAS 
230 REM W 
********** 

2) [2,211]TEST2.BAS 
222 REM 4 

224 REM 5 
230 REM W 


?3 Differences Found 


Output to <KB:>? <CTRL/2> 
$ 


FILCOM displays the lines from both files that do not compare, 
followed by the first line that does compare. The first line in each 
group is the first line that differs and the last line in each group 
is the first line that is the same. 
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In this example, the first group consists of lines 40 through 70 in 
TEST1.BAS. FILCOM displays line 40 because it has no match in 
TES 2 . BAS. FILCOM continues to display TESTl until it finds three 
matching lines (the default), the first line of which is line 70. 

As another example, consider the following two programs: 

FILEl.BAS FILE2.BAS 


5 

EXTEND 


5 

EXTEND 



10 

REM A 



1 

REM A 



20 

REM B 



20 

REM B 



30 

REM C 

& 


30 

REM C 



\ 

PRINT 

"LINE 

30" 

40 

REM D 



40 

REM D 



50 

REM E 

& 


50 

REM E 

& 


\ 

PRINT 

"LINE 

50 

\ 

PRINT 

"LINE 

50" 

70 

REM F 



60 

REM F 



80 

REM G 

& 


70 

REM G 



\ 

PRINT 

"LINE 

80 

80 

END 



90 

END 




The following series of commands directs FILCOM to create a file named 
FIL.DIF and to write the results of the comparison of FILEl.BAS and 
FILE2.BAS to that file: 

$ RUN $FILCOM 

FILCOM V9.0 RSTS V9.0 

File Comparison Program 13-JUN-85 11:54 AM 

Output to <KB:>? FIL.DIF=FILE1.BAS,FILE2.BAS/BA/MA:2/SU 

Output to <KB:>? <CTRL/Z> 

$ 

The specified switches instruct FILCOM to consider BASIC-PLUS 
continuation lines as part of a numbered program line and to write 
differences when more than two lines fail to match. The /SU switch 
directs FILCOM to write a summary of the differences in FIL.DIF. 

After completion of the comparison, FIL.DIF contains the following: 

FILCOM V9.0 RSTS V9.0 

File Comparison Program 13-JUN-85 11:54 AM 
Comparing: 1) [2,211]FILEl .BAS TO 2) [2,211]FILE2 .BAS 

?2 Differences Found. 
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The following series of commands directs FILCOM to display the results 
of its comparison of FILEl.BAS and FILE2.BAS on your terminal. 

However, the number of lines needed to match is four, and a full 
description of the differences is requested: 

$ RUN $FILCOM 

FILCOM V9.0 RSTS V9.0 

File Comparison Program 16-DEC-84 11:54 AM 
Output to <KB:>? FILEI.BAS,FILE2.BAS/BA/MA:4 

Comparing: 1) [2,211]FILEl.BAS TO 2) [2,211]FILE2.BAS 

****************************** 

1) [2,211JFILE1.BAS 


30 

REM C 

& 


\ 

PRINT 

"LINE 

30" 

40 

REM D 



50 

REM E 

& 


\ 

PRINT 

"LINE 

O 

in 

60 

REM F 



70 

REM G 



80 

END 



★★★★★★★★★★ 



2) 

[2,211]FILE2.BAS 


30 

REM C 



40 

REM D 



50 

REM E 

& 


\ 

PRINT 

"LINE 

50" 

70 

REM F 



80 

REM G 

& 


\ 

PRINT 

"LINE 

S 

O 

CO 

90 

END 



?1 

Difference 

Found. 


Output to <KB: 

>? <CTRL/Z> 


$ 
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FILCOM Error Messages 

Table 2-8 lists the FILCOM error messages and their meanings. 
Table 2-8: FILCOM Error Messages 


Message and Meaning 


?A NULL LENGTH FILE? 

The file examined by FILCOM (the first or second input file) is 
empty. 

?FILE HAS NON-ASCII STREAM ATTRIBUTE - CAN'T READ <filename> 

The file <filename> contains file attribute data that is not 
ASCII stream. The FILCOM program can only compare ASCII file 
data. After FILCOM returns this error, it continues to the next 
set of files or prints the Output to <KB:>? prompt. 

?ILLEGAL COMMAND LINE X 

The FILCOM command line or file specification contains illegal 
syntax. 

?ILLEGAL FILENAME <filename> 

The file name specification (input or output) is syntactically 
incorrect. 

?ILLEGAL FILENAME X CREATED FROM y BY 2 

Based on the wildcard input file specification (y and z), FILCOM 
would have created a file name (x) of illegal syntax. After 
FILCOM returns this error, it continues to the next set of files 
or prints the Output to <KB:>? prompt. 

’LIMIT n REACHED ON LAST COMPARE, SKIPPING REST OF FILE <filename> 
The number of differing lines in a single compare (n), specified 
by the /LI switch, is exceeded. FILCOM continues to the next set 
of files or prints the output to <KB:>? prompt. 

’LINE TOO LONG AT LINE n 

FILCOM attempted to input a line at program line number n that 
is greater than 255 characters. The program continues to compare 
the rest of the lines in the file. 

?OUTPUT FILENAME 'file.type' WOULD OVERWRITE AN INPUT FILE, 
SKIPPING COMPARE 

During a check of the input and output file specifications, 
FILCOM discovered an output specification that would cause the 
overwriting of an input file. FILCOM aborts the operation. 
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Table 2*8: FILCOM Error Messages (Cont.) 


Message and Meaning 


| ’WILDCARD FILENAME ILLEGAL ON DEVICE x 

You typed a wildcard specification for a first input file that 
| does not reside on a disk device. 

| ’WILDCARD ILLEGAL FOR OUTPUT FILENAME <filename> | 

| FILCOM requires either a file name or type in the output file 
| specification. You can use a wildcard for one of these fields 
| (but not both), or you can default both fields. 

I I 

| 7WILDCARD PPN SPECIFICATION ILLEGAL 

| You cannot use wildcard characters in the PPN field. 

+.*.. 
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Transferring Files Between Devices: The FIT Program 


files between RSTS/E 


The FIT (File Transfer) program transfers 

directory-structured devices and RTll directory-structured devices 
FIT can also transfer files from DOS directory-structured disks 
RSTS/E directory-structured devices, and list device 
can perform the following tasks: 


to 

directories. 


FIT 


o Transfer files between RSTS/E structured devices and RTll 
structured devices. This includes transfers between RSTS/ 
devices and RX01 or RX02 flexible diskettes that are 
maintained in the RTll directory-structured format. 


o Transfer files from a DOS disk to a RSTS/E device. 

o List the directory of a RSTS/E, RTll or DOS structured 
device, including RX01 and RX02 flexible diskettes. 

o Delete files on an RTll structured device. 

o Initialize (zero) an RTll structured device. 

o Compress (squeeze) the files on an RTll structured device. 


Privilege Required 

To run the FIT program and use its various features, you need the 
following: 

o Read access to input files and files included in a directory 
listing 

o Create/Rename access to any output files you create 
o Write access to any files you delete 

o DEVICE privilege for restricted tape drives and restricted 
RX01/RX02 disk drives 

o RDNFS privilege for non-RSTS/E input disk devices 

o WRTNFS privilege for non-RSTS/E output disk devices 

o SYSIO privilege to set the protection/privilege bit when 
transferring files to a RSTS/E system 
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Running the FIT Program 
To run FIT, type: 

$ RUN AUXLIB$:FIT 

FIT displays an identifying header followed by the FIT> prompt: 

FIT V9.0 RSTS V9.0 
FIT> 

The prompt indicates that FIT is ready to accept a command line. 

You can obtain help on using FIT by typing /HE in response to the FIT 
prompt. 

To exit from FIT, enter CTRL/Z in response to the prompt. 


Transferring Files with FIT 

To transfer a file with FIT, type a command line of the following 
format in response to the FIT prompt: 

[output[/sw]-]input[/switch] 

where: 

input and are file specifications, 
output 

/switch is an optional switch that specifies the structure 

of the device on which the file resides. Specify: 

o RSTS 

o RTll 

O DOS 

o /WATCH to cause FIT to log its file transfers 

The input and output file specifications can be full RSTS/E 
specifications of the following format: 

dev:[proj,prog]filename.type/PROT:n 
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where: 


dev: 

specifies a device. If you do not specify a 
device, the default is the public structure. 
Legal output and input devices are explained 
later in this section. 

proj,prog 

is the project-programmer number (PPN). If you 
do not specify one, the default is your current 
account. FIT ignores the PPN if the device has 
an RTll directory structure. You can also use 
wildcards (see the PIP utility section 
"Wildcard Specifications"). 

filename.type 

is the file name consisting of one-to six- 
alphanumeric characters and, optionally, a file 
type consisting of one-to three-alphanumeric 
characters. If you omit the file name and type 
for output, FIT uses the input file name and 
type. For input, however, you must specify a 
file name. You can also use wildcards (see the 
PIP utility section "Wildcard Specifications"). 

/PROT:n 

is the file protection code. If you omit the 
protection code on output, FIT assigns your 
current default protection code. FIT ignores any 
input file protection code specification. If you 
have SYSIO privilege, you can set the protection 
privilege bit. 


The legal input devices for a FIT file transfer are: 

o Any disk with a RSTS/E directory structure. 

o Any disk, diskette, or DECtape with an RTll directory 
structure. This includes RTll disks, RX01/RX02 flexible 
diskettes, and TU56 DECtape. 

o Any disk with a DOS directory structure. 

The legal output devices (except for DOS input) for a FIT file 
transfer are: 

o Valid RSTS/E devices. These include RSTS/E disks, magtape, 
TU56 DECtape, keyboards, and line printers. 

o Devices with an RTll directory structure. These include RTll 
disks, RX01/RX02 flexible diskettes, and TU56 DECtape. 
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If the input device is a DOS disk, the legal output devices are all 
valid RSTS/E devices. These include RSTS/E disks, magtape, TU56 
DECtape, keyboards, and line printers. 


You cannot use FIT to directly transfer files from a DOS disk to 
magtape or to an RTll structured device. The algorithm that FIT uses 
to output to these devices requires that it know the file length ahead 
of time. Since DOS disks do not contain this information, FIT does 
not support direct transfers from DOS disks to RTll devices. 

If you need to perform such a transfer, you can do it in two steps: 


1. Transfer the files from the DOS disk to a RSTS/E disk 

2. Perform a second transfer from the RSTS/E disk to the RTll 
device 


The specifications you can use for /switch in the command line for 
file transfer operations are: 


Switch Abbreviation 

/RTll /RT 


/DOS /DO 


/RSTS /RS 


/WATCH /W 


Description 

The file is on an RTll 

directory-structured device. When you 

specify this 

switch, FIT ignores files with a .BAD 
file type on transfers and deletions. 

When you also specify the /SQ switch (see 
the section "Compressing an RTll 
Structured Device"), FIT displays a 
warning message and aborts the 
compression when it finds a .BAD file 
type. 

The file is on a DOS format disk. This 
switch is legal only for an input file 
specification. 

The file is on a RSTS/E disk or device. 
This switch is illegal with RX01 and RX02 
flexible diskettes. 

When you specify this optional switch, 

FIT logs file transfers on your terminal. 


The following example shows copying a file and using the /W switch: 

$ RUN AUXLIB$:FIT 

FIT V9.0 RSTS V9.0 

FIT> DYl:«[1,2]COMMON.MAC/W 

[File SY:[1,2)COMMON.MAC copied to DYl:[COMMON.MAC] 
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Listing the Directory of a Device 

Use the /LI or /DI switch to list the directory of a device on your 
terminal. The command line has the following format: 

dev:[proj,prog]filename.type/L[I][/sw] 

where: 


dev: 

\ 

specifies the device designator. The default is 
the system disk (SY:). 

proj,prog 

specifies the project-programmer number (PPN) 
of the directory you want to list. The default 
is the current account. This field can contain 
wildcards* See the PIP utility section 
"Wildcard Specifications." 


filename.type specifies the file names and types of the files 



you want to list. The default is all files in 
the current account. This field can contain 
wildcards. 

/LI 

specifies the directory listing switch. You can 
also use /DI in the command line. You can 
abbreviate these switches to /L and /D. 

/sw 

specifies an optional switch for the directory 
structure of the device. 


The following example shows the use of the /LI switch: 

$ RUN AUXLIB$:FIT 

FIT V9.0 RSTS V9.0 


FIT> DYl:/LI 
Directory of 

DYl:?????.??? 

Name .Typ 

COMMON.MAC 

RF:STM 

Size Date RTS Pos 

41 13-Jun-85 TECO 26 

FO:SEQ USED:41:165 RECSI:85 

<UNUSED> 

427 67 


Total of 41 blocks in 1 file in DYl: 

Total of 427 free blocks in DYl: 

For RT11 file-structured devices, FIT also displays file attributes if 
the directory has 13 extra words for each entry (see the section 
"Initializing an RTll Structured Device"). Those sections of the 
directory that have free space are flagged as UNUSED in the listing. 
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You can include one of the following optional switches with the /LI or 
/DI switch: 


Switch 

Meaning 

/RTll 

Indicates that the device must have an RTll directory 
structure. If you include this switch and the device is not 
an RTll device, FIT returns an error message. You can 
abbreviate this switch to /RT. 

/DOS 

Lists the directory of a DOS disk. This operation generates 
a listing for each file that includes account number (UIC), 
file name, file type, file length, protection code, date of 
creation, the first block number of the file, and whether or 
not the file is contiguous. If you include the /DOS switch 
and the device is not a DOS disk, FIT returns an error 
message. You can abbreviate this switch to /DO. 


If you do not include an additional switch with the /LI operation, FIT 
lists the directory of the device whether it is DOS, RSTS/E, or RTll 
directory structured. 

Deleting Files on an RTll Structured Device 

You can use the /DE switch to delete a file on an RTll 

directory-structured device. To delete a file, type a command in the 

following format in response to the FIT> prompt: 

dev:filename.type/DE[/switch] 


where: 


dev: 

specifies the device designator. It must be an 

RTll structured device. 


filename.type specifies the file names and types of the files 



you want to delete. This field can contain 
wildcards (see the PIP utility section "Wildcard 
Specifications"). 

/DE 

specifies the file deletion switch. 

/WATCH 

directs FIT to log each file deletion on your 
terminal. You can abbreviate this switch to /W. 


If the specified device is not RTll directory structured or if the 
file does not exist, FIT displays an error message. If FIT finds an 
error as it accesses the device, it reports a RSTS/E error. 
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Initializing an RTll Structured Device 

You can initialize (zero) an RTll structured device by typing a 
command in the following format in response to the FIT> prompt: 

dev :/ZE': m[ /swi tch ] 
where: 

dev: specifies the device you want to initialize. 

/ZE is the switch that tells FIT to initialize the specified 

device. If you specify a value for m, FIT adds m extra 
words of directory information for each file to the minimal 
RTll directory structure. If you omit m, FIT adds 13 extra 
words. 


Note 

RT-11 systems currently ignore these extra directory 
words. However, if future releases of RT-11 attach 
significance to these words, you may have to specify 
the /ZE:0 switch for RTll files that are to be read by 
RT-11 systems. FIT currently ignores extra directory 
information unless there are 13 extra words (this may 
change in future releases). Therefore, you should 
specify only values of 0 or 13 for m with the /ZE 
switch. 

The following example shows initializing a device: 

$ RUN AUXLIB$:FIT 
FIT V9.0 RSTS V9.0 

FIT> DYl:/ZE 
Really zero DYl:? y 


Note 

Never use FIT to initialize an RTll disk that isolates 
bad blocks in .BAD files. Initializing such a device 
destroys the bad block information. If you want to 
delete all files except the .BAD files, perform a 
wildcard delete operation using the /RTll switch (see 
the previous section). 

You can also use the /N switch with the /ZE switch to create more 
directory segments on the initialized device. The switch has the 
format: 

/N:n 
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where: 


/N: is the switch that tells FIT to add segments to the 

directory. You can use /N to control the size of the 
directory on the device, and therefore, the number of files 
stored on that device. 


n specifies the number of segments you want to add to the 

directory. Each segment consists of two 512-byte blocks. The 
value of n must be in the range 1 to 31. Use the following 
formula to determine the maximum number of files that can fit 
on a device: 


Max Files = n*INT(507/(m+7)) 

In this formula, n is the number of directory segments and 
m is the number of extra words for each directory entry 
(that is, /N:n and /ZE:m, respectively). You may have to 
compress the device with the /SQ switch (see the following 
section) before the maximum number of files is reached. 

If you do not specify n, FIT applies defaults based on the 
device capacity (in blocks). 

Table 2-9 lists the defaults and the maximum number of files allowed 
on a particular device as determined by your specification in /ZE:m. 

Table 2-9: FIT Initialization Defaults 


+.+.+.+. 

I I | /ZE:0 I /ZE:13 

| Device j +.+.+.+. 

I Capacity j | Directory | Maximum | Directory | Maximum 

j (Blocks) j Device j Segments j Files j Segments | Files 

+ —.+.+.+.+ - . + . 

I I RX01 III | 

| < 1000 | RX02 | 4 | 288 | 10 | 250 

I I RX50 III | 

+.+.+.+...+ ---.+. 

| > 1000 I RK05 II | | 

| and | RK05F | 16 | 1152 | 31 | 775 

I < 10000 || || . | 

+.+.-- +.+.+.+. 

| > 10000 I * I 31 I 2232 | 31 | 775 

+.+.+.+.+.+. 

| * See the RSTS/E System Manager's Guide for specific devices 
j with a capacity greater than 10,000 blocks. 

.. 


+ 

I 

+ 


+ 


+ 


+ 

I 

+ 


+ 
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Compressing an RTll Structured Device 

You can compress (squeeze) an RTll structured device by typing a 
command in the following format in response to the FIT> prompt. 

FIT dev:/SQ(/sw) 

The /SQ switch compresses the files that are currently on the device 
you specified in dev:. Use the /SQ switch to make room on an output 
device for additional files that you want to transfer to the device. 

The space on RTll devices allocated to the directory of files can 
become fragmented. If this is the case, an attempt to add another 
file to the device can result in the error message ?Directory overflow 
or ?Device full. You can use the /SQ switch to compress the contents 
of the device and attempt to provide enough room for the additional 
files. If you interrupt a compress operation, data may be lost on the 
device you are compressing. Thus, FIT,ignores any CTRL/C you enter at 
the keyboard during a compress operation. 

If you also specify the /RTll switch, FIT first inspects the device to 
see if it contains any files with the .BAD file type. If it does, FIT 
displays an error message and aborts the compress operation. 

Because of the way that RTll directory entries are made, you may need 
to compress the device to use the directory space, even if you add 
files contiguously without deletions. 

Note 

RTll format DECtape (TU56) is much slower to access 
than RSTS/E format DECtape. You should use the /SQ 
switch only when necessary to transfer between RSTS/E 
and RT-11 systems. For example, a FIT compress 
operation (/SQ) on an RTll DECtape can take an hour or 
longer. 


Maintaining RTll Format with Bad Block Files 

The RT-11 operating system requires that files used to contain bad 
blocks have a .BAD file type. Use the following procedure to transfer 
files between RSTS/E and RT-11 systems on disks that contain bad 
blocks: 

1. First initialize a disk that contains bad blocks on an RT-11 
system before FIT can process it. The RT-11 system locates 
the bad blocks and allocates them to files with a .BAD file 
type. 
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2. Include the /RT11 switch (see the previous section) with the 
file specification whenever you reference the disk in the FIT 
command line. 

This procedure directs FIT to ignore any files with a .BAD type on 
transfer to and from RT11 devices. FIT also ignores .BAD files on 
delete operations. During compress operations (see the previous 
section) FIT displays an error message and aborts the operation if it 
detects a .BAD file. 


FIT Error Messages 

If FIT finds an error during the open or transfer phase of a RSTS/E 
file operation, it returns the appropriate RSTS/E error (see the 
RSTS/E System User's Guide) and aborts the transfer. 

FIT generates errors related to an RTll directory structure before 
transferring any data to the RTll structured device. Because FIT does 
not finalize the directory entry for the RTll file until the transfer 
is complete, an error during transfer frees the space reserved for the 
f ile. 

Table 2-10 lists the FIT error messages and their meanings. 

Table 2*10: FIT Error Messages 


Message and Meaning 


Common Directory Structure Errors 


?ARGUMENT NEEDED FOR 

You specified the /N switch without an argument. 

?CANNOT OUTPUT TO DOS 

A DOS format disk is valid for input only. 

?CAN'T ZERO A MOUNTED RSTS/E DISK 

You cannot zero a RSTS/E mounted disk. 

?CONFLICTING SWITCH 

You specified an invalid switch combination. 

7DEVICE <device-type> HAS <text> STRUCTURE 

You specified an /RTll, /RSTS/E, or a /DOS device switch and 
the device does not have that structure. 
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Table 2-10: FIT Error Messages (Cont.) 

.. 

| Message and Meaning 


| Common Directory Structure Errors 

+. 


+ 

I 

+ 

I 

+ 


7DEVICE NOT ALLOWED FOR INPUT 

The specified input device is not a legal device. 

?ILLEGAL ARGUMENT IN 

You specified an illegal switch argument. 

?ILLEGAL OPERATION FOR DEVICE 

The specified operation is illegal for the specified device. 

’ILLEGAL WILDCARDS FOR OUTPUT 

You cannot use the ? character in the output file 
specification. 

?NO FILES MATCHING 

The specified file name for the directory listing does not 
exist. 

’NO INPUT FILE 

You did not specify a file name or a device. 

’NOT A RECOGNIZED DIRECTORY STRUCTURE 

The specified device is not an RTll, RSTS/E, or a DOS 
structure. 

?OPERATION DOES NOT TAKE OUTPUT SPEC 

You cannot specify an output file specification using the /LI, 
/DE, /ZE, /SQ, and /HE switches. 

?PROGRAM MUST BE PRIVILEGED 

The program has insufficient privileges to run properly. Set 
the privilege bit in the protection code. 

7RSTS/E DISK NOT MOUNTED 

The specified disk is not mounted. 

?UNRECOGNIZED SWITCH(ES) 

You specified an invalid switch. 
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Table 2-10: FIT Error Messages (Cont.) 


Message and Meaning 


RTll Directory-Structured Errors 



| 7DEVICE FULL 

| Either there is not enough space in the directory or you are 
1 attempting to transfer a file larger than 65,535 blocks to an | 
| RTll structured device. | 

i j 

j 7DEVICE HAS .BAD FILE(S) 

| You cannot compress an RTll structured device that has .BAD 
| files 

I 1 

| 7DEVICE TOO LARGE 

j You cannot initialize a device that is larger than 65,535 
| blocks. j 

I 

! 

| 7DIRECTORY CORRUPTED 

I The specified RTll directory structure is corrupted. 

I | 

| 7DIRECTORY OVERFLOW 

| The output device has no more space for directory entries. It | 

| may be possible for you to use the /SQ switch (see the section j 

| "Compressing an RTll Structured Device") to free more space for | 

| the directory. If this is not successful, you must delete some 
| of the files on the device before youcan add more. Note that | 

| if you intend to have many small files on the device, you 

| should use the /N switch to allocate more than the default 

| number of directory segments.(see the section, "Initializing an j 

I RTll Structured Device") when you initialize the device. 

I | 

! ?FILENAME AND TYPE NEEDED FOR /DE | 

| You must specify a file name and a file type when deleting a j 

| file from an RTll structured device. j 

j • 

j ?ILLEGAL INPUT FOR RTll OUTPUT 

| You cannot transfer files from a DOS disk to an RTll structured | 

I device. 

I I 

| ?/ZE MUST BE SPECIFIED WITH /N | 

| When creating additional segments, you must include the /ZE , j 

| switch when using the /N option. j 

+.+ 
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Transferring Diskette Information: The FLINT Program 

The FLINT program (FLexible diskette INTerchange) transfers 
information between IBM flexible diskettes and standard RSTS/E disk 
files. FLINT can only transfer information between single density IBM 
flexible diskettes, which are mounted in RX01/RX02 drives, and RSTS/E 
disks. FLINT cannot process double density IBM diskettes. You can 
use FLINT to perform the following operations: 

o Transfer information from IBM flexible diskettes to standard 
disk files that RSTS/E can read (for example, DK:, DP:, SY:). 
FLINT can also transfer files that reside on multiple 
diskettes. 

o Transfer information from RSTS/E readable disks to the 
diskettes that an IBM system can read. FLINT can also 
transfer large files that require multiple diskettes. 

o List the directory of an IBM diskette. This directory 

contains information related to the unique data format of an 
IBM diskette. 

o Initialize the directory of a diskette. 

o Initialize the directory and erase all data on a diskette. 

To perform these operations, FLINT communicates with you by dialogue. 
There are two different dialogues for the transfer operations: 

IBM-to-RSTS/E and RSTS/E-to-IBM. There are also dialogues for listing 
an IBM directory, initializing, and erasing a diskette. 


Privilege Required 

To run the FLINT program and use its various features, you need the 
following: 

o Read access to input files and files included in a directory 

listing 

o Create/Rename access to any output files you create 
o Write access to any files you delete 

o DEVICE privilege for restricted RX01/RX02 disk drives 
o RDNFS privilege for non-RSTS/E input disk devices 
o WRTNFS privilege for non-RSTS/E output disk devices 
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Running FLINT: The Initiation Commands 
To run FLINT, type: 

$ RUN AUXLIB$:FLINT 

FLINT displays an identifying header, followed by a # prompt. This 
indicates the program is ready to accept one of five initiation 
commands. Each of the following commands initiates a different 


dialogue: 


Command 

Initiates the dialogue to: 

/DIRECTORY 

List an IBM diskette directory 

/TORSTS 

Transfer from an IBM diskette to a RSTS/E disk file 

/TOIBM 

Transfer from a RSTS/E disk file to an IBM diskette 

/ZERO 

Initialize the directory of a diskette 

/ERASE 

Initialize the directory and erase all data on a 
diskette 


You can abbreviate each command (at the minimum) to its first three 
letters: /DIR, /TOR, /TOI, /ZER, and /ERA. 

After FLINT completes a file transfer, it returns to the # prompt. To 
exit from FLINT, enter CTRL/Z. 

Listing the Directory of an IBM Diskette 

Type /DIR in response to the # prompt to begin the two-question 
dialogue for listing the directory of an IBM diskette. In the 
following dialogue description, explanations follow FLINT'S questions. 

Output to? 

This question asks you where you want FLINT to output the directory of 
the diskette(s). Press RETURN to display the output on your terminal. 
If you want to write the output to a file, include an output file 
specification. The full file specification has the following format: 

dev:(proj,prog]filename.type/PROT:n 
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where: 
dev: 


specifies the device. You must specify the 
device name. 


[proj,prog] 


filename.type 


n 


specifies the project-programmer number (PPN). 

The default is the current account. 

specifies the file name and file type for the 
output file. You can use the * and the ? 
wildcard characters in the file name and file 
type fields. You must specify at least the 
file name. 

specifies the file protection. The default is 60. 


FLINT then prompts for the location of the IBM diskette(s): 


Directory of? 


This question asks you to specify the location of the IBM diskette(s) 
whose directory you want listed. Press RETURN to specify diskette 
DXO. Type any other disk specifications in the form DXn: or n, where 
n is an integer between zero and seven. You must separate 
multidiskette specifications with commas. 

The following example displays the directory of an IBM diskette on 
your terminal: 

$ RUN AUXLIB$:FLINT 
FLINT V9.0 RSTS V9.0 
#/DIR 

Output to? <RET> 

Directory of? DXl: 

DIRECTORY OF DXl: 


DSN 

BRL 

BOE 

EOE 

EOD 

DATA 

080 

01001 

73026 

01001 

TOTAL 

OF 1 

DATA SET 

ON DXl: 



MVI VSN 
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Table 2-11 lists and describes the abbreviated headings for the IBM 
diskette directory. 


Table 2-11: 

FLINT Abbreviated Directory Headings 

+.+ 



| Heading | 
+.+ 

Name 

I Meaning 

1 1 

| DSN | 

1 1 

1 1 

| 

Data Set Name 

1 

| The one- to eight - character name you 
| have given the data set (corresponds 
| to file name in RSTS/E). 

| BRL 

1 1 

1 1 

| 

Block/Record 

Length 

1 

| The number of positions (bytes) 
j containing data in each 128-position 
j (byte) sector. 

| BOE 

1 1 

1 1 

1 1 

Beginning Of 
Extent (BOE) 

j The address of the first sector in 
| the data set; output is in the form 
j ttOss, where tt is track number and 
| ss is sector number. 

| EOE 

1 1 

1 1 

| 

End Of Extent 
(EOE) 

1 

| The address of the last sector 
j reserved for this data set (in the 

j same format as BOE). 

' 

| EOD 

1 1 

1 | 

End Of Data 
(EOD) 

| The address of the next unused sector 

j within the data set extent. 

1 

1 1 

1 BI | 

1 1 

Bypass Indicator 

| A space in this field means the data 
j set is intended for processing; a B 

| means it is not. 

1 

1 1 

| MVI | 

1 1 

1 1 

1 1 

1 1 

1 1 

1 | 

Multivolume 

Indicator 

■ 

| A space in this field means a data 
j set is wholly contained on this 
j diskette; a C means that a data set 
j is continued on another diskette; an 
j L means that this diskette is the 
j last on which a continued data set 

j resides. 

1 

1 1 

| VSN | 

1 1 

1 1 

1 1 

+.+ • 

Volume Sequence 
Numbe r 

1 

| The sequence of volumes in a 
| multivolume data set. Blanks indicate 
j that volume sequence checking is not 
j to be performed. 
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Transferring IBM Diskette Data to RSTS/E 

Type /TOR in response to the # prompt to begin the dialogue for 
transferring IBM diskette data to a standard RSTS/E disk file. In the 
following dialogue description, explanations follow FLINT'S questions. 

Output to? 

This question asks you to specify the RSTS/E file that is to receive 
data from the diskette(s). Respond with an output file specification 
that has the format: 


dev:[proj,prog]filename.type/PROT:n[/NH] 


where: 
dev: 


[proj,prog] 


filename.type 


n 

/NH 


specifies the RSTS/E disk device. The default is 
the system disk. 

specifies the project-programmer number (PPN). The 
default is the current account. You cannot use 
the * and the ? wildcard characters. 

specifies the file name and file type of the 
file to receive the output of the diskettes. 

specifies the file protection. The default is 60. 

specifies the optional switch that eliminates 
the 6-byte header. 


FLINT then prompts for translation: 


Translate from EBCDIC to ASCII <Yes>? 

This question asks you if you want FLINT to translate the diskette 
data from its current EBCDIC format (unreadable by RSTS/E) into ASCII 
format, which is readable by RSTS/E. Pressing RETURN directs FLINT to 
translate the data. If you type NO, FLINT does not translate the 
data. 


Input from? 

This question asks you to specify the location of the IBM diskette(s) 
from which FLINT will transfer data. Press RETURN to specify diskette 
DXO. You can specify a different location by typing a response in the 
format: 


DXn: 

or 

n 
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where DXn refers to the location of the input diskette(s) and n is an 
integer from zero to seven. 

FLINT then proceeds with the transfer of the first data set from the 
specified diskette. FLINT displays a message in the format: 

dsn is the Data Set Being Transferred 

where dsn refers to the name of the first data set on the first 
diskette. 


If you want FLINT to transfer a specific data set, give a response in 
the format: 

DXn:dsn 

where: 

DXn refers to the location of the input diskette(s) and n is 

an integer from zero to seven. 

dsn specifies the data set name, containing one to eight ASCII 

characters, including blanks (spaces and tabs). FLINT 
recognizes these blanks as part of the IBM data set name. 
If FLINT cannot find the specified data set, the program 
displays the informational message ?File not found, 
followed by the Input from? prompt. 

FLINT examines the data set label, which is a header with statistical 
information, to determine if the data set resides on more than one 
diskette. If the transfer requires more than one diskette but you 
specify only one diskette, FLINT displays this message: 

dsn Resides on more than one diskette - 
Do you Wish to CONTINUE <NO>? 

If you type YES, FLINT proceeds to its next question. If you press 
RETURN to accept the default response, FLINT aborts the transfer and 
displays the # prompt. 

FLINT next computes the blocking factor it uses in the transfer of the 
current data set and displays a message expressing that factor as the 
ratio of IBM to RSTS/E records. This message has the format: 

N XXX Character IBM Records = 1 RSTS Record 

FLINT computes this blocking factor by determining how many of the 128 
positions (bytes) in each diskette sector contain data in the form of 
characters. This count is the IBM record size. FLINT divides the 
RSTS/E record size by the IBM record size and displays the quotient, 
rounded down to the nearest integer, as N in the previous message. 
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For example, if each IBM record contains 80 data characters, FLINT 
places 6 full IBM records in a 512-byte RSTS/E record (512/80 - 6.4). 
FLINT displays the message: 

6 80 Character IBM Records = 1 RSTS Record. 

After displaying the blocking factor message, FLINT transfers the data 
from each specified input device. 

When FLINT copies data from IBM diskettes whose record size does not 
divide equally into the RSTS 512 byte record size, it transfers N data 
records and then fills the extra space with null characters. In the 
previous example, FLINT transfers six 80-byte records from the IBM 
diskette, using 480 bytes of storage in the RSTS/E file. FLINT then 
fills the remaining 32 bytes with null characters before proceeding 
with the next record transfer. 

If the specified input device does not contain the entire data set, 
FLINT displays the question: 

Next Input Device? 

Respond with the number of the drive on which the next portion of the 
data set resides. FLINT continues to transfer data and display Next 
input device? requests until the current diskette contains the end of 
the specified data set. 

On multivolume input, FLINT continually checks data set names against 
the one you specify and, if possible, also checks volume numbers for 
correct sequence. For example, if FLINT is transferring the data set 
IDAT and the third input volume specified contains no IDAT, FLINT 
displays the message: 

File Not Found - DXn:IDAT 

FLINT then displays the message: 

Next Input Device? 

If the volumes contain sequence numbers, and the number on a 
particular diskette is not one greater than that on the previous 
diskette, FLINT displays the message: 

Volume #[m] cannot follow Volume #[n] 

FLINT then displays the message: 

Next Input Device? 
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If no fatal errors occur, FLINT completes the IBM-to-RSTS/E transfer 
and displays a summary message that has the format: 

Exchange Completed 
X IBM Records Read 

Y Logical (Z Physical) RSTS Records Written 
where: 

X indicates the number of IBM records read. 

Y indicates the number of logical RSTS/E records written. 

Z indicates the number of physical RSTS/E records used. 


Specifying the Known Diskettes of a Data Set 

Before you begin the transfer of a multivolume data set, you may know 
on which diskettes the data set resides. Respond to the Input from? 
question by specifying the diskette on which the data set begins, then 
the data set's name, and finally the other diskette(s) on which the 
data set is continued. For example: 

Input from? DXl:DATASETA,DX2:,DX3:,DX4 

In this example, you tell FLINT to mount (in order) the diskettes 
containing DATASETA on consecutively numbered drives. You can mount 
and specify diskettes out of sequence but there is a chance for 
confusion. If the unsequenced order of specifications does not match 
exactly the unsequenced order of mounting, FLINT displays the message: 

?Volume #[m] cannot follow Volume #[n] 


Format of RSTS/E Disk File Header Records 

The first logical record on the RSTS/E output file is reserved for a 
statistical header. This header is six bytes long, and contains the 
following information (all fields are 2-byte integer fields in 
standard CVT%$ format; see the BASIC-PLUS Language Manual): 

Bytes Contents 

1-2 Physical block number of the last logical block in the file. 

3-4 Number of logical records in the last physical block. 

5-6 Logical record length in bytes. 
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When FLINT begins the data transfer, it copies the statistical header 
into the first six bytes of the first RSTS/E logical record. It then 
fills the rest of the logical record with null characters before 
continuing with the data transfer. Note that if the logical record 
size of the IBM diskette is less than six bytes, the FLINT program 
requires two RSTS/E logical records in which to store the statistical 
header. 

Use the /NH switch in response to the Output to? dialogue question to 
stop the transfer of this statistical header. For example: 

Output to? DKO:INFO.DAT/NH 

In this example, you tell FLINT to transfer data to the file INFO.DAT 
on disk drive DKO:. FLINT does not transfer the statistical header, 
and begins the data transfer at the first logical record on the RSTS/E 
disk file. 


Transferring RSTS/E Files to IBM Diskettes 

Type /TOI in response to the # prompt to begin the dialogue for 
transferring a RSTS/E disk file to IBM diskette(s). In the following 
dialogue description, explanations follow FLINT'S questions. 

Output to? 

This question asks you to specify the IBM data set that is to receive 
data from the RSTS/E disk. Respond with a data.set name in the 
following format: 

DXn:dsn 

where: 

DXn: specifies the diskette you want to receive the data set and 

n is a device number from zero to seven. 

dsn specifies the output data set name composed of one to eight 

characters including blanks. If you omit dsn, FLINT 
assumes the name RSTS. 

You must separate multivolumes with commas. For example: 

DXO:DATSETC,DX2: 

FLINT then prompts for translation: 

Translate from ASCII to EBCDIC <Yes>? 
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This question asks if you want FLINT to translate the RSTS input data 
from its current ASCII format into EBCDIC format. Pressing RETURN 
tells FLINT to translate the data. If you type NO, FLINT does not 
translate the data. 

Input from? 

This question asks you to specify the location of the RSTS/E file from 
which FLINT will transfer the data. Specify an input file in RSTS/E 
format: 

dev:[proj,prog]filename.type 
where: 

specifies the RSTS/E disk device. The system disk 
is the default. 

specifies the PPN. You cannot use the * and the ? 
wildcard characters. The default is the current 
account. 

FLINT then prompts for the record length: 

Record Length <128>? 

This question asks you to specify the size (in bytes) of each IBM 
output record. As the default of 128 indicates, press RETURN to 
specify output records that contain 128 characters each. IBM records 
contain 1 to 128 characters and are fixed length. To specify a 
shorter record length, type any number that is a power of 2 within the 
range 0 to 128 (that is, 2, 4, 8, 16, 32, or 64). 

Note 

To make sure that no data is lost in transfer, you 
must specify a record size that divides equally into 
the RSTS/E 512-byte record size. You can specify any 
number that is a power of 2. 

If you specify any other record size, FLINT transfers 
data from each 512-byte record to N IBM records (see 
the following blocking factor information) ignoring 
any left over data in the RSTS/E record. It then 
proceeds to the next RSTS/E record for transfer. 

For example, if you specify an IBM record length of 
80, FLINT transfers six 80-byte records to the IBM 
diskette, for a total of 480 bytes. FLINT then 
ignores the 32 data bytes remaining in the RSTS/E 
record and proceeds to the next record. 


dev: 

[ proj,prog] 
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FLINT next computes the blocking factor to use in the transfer of 
RSTS/E data, and displays a message expressing that factor as the 
ratio of IBM to RSTS/E records. This message has the format: 

1 RSTS Record = N IBM Records 

FLINT computes this blocking factor by determining how many of the 128 
positions (bytes) in each diskette sector contain data in the form of 
characters. This count is the IBM record size. FLINT divides the 
RSTS/E record size by the IBM record size and displays the quotient, 
rounded down to the nearest integer, as N in the previous message. 

After computing the blocking factor, FLINT proceeds with the transfer. 

If FLINT determines that the RSTS/E file will not fit on the number of 
diskettes you specify, FLINT displays the question: 

Volume #(n + 1)? 

This question asks you to specify an additional diskette for output. 
Type a response in the format: 

DXn: 

or 

n 

where DXn specifies the diskette you want to receive the data set and 
n is a device number from zero to seven. 

FLINT continues to ask the Volume #? question and to accept one of 
these responses until it can complete the transfer. For all diskettes 
used in the transfer, FLINT labels each diskette with volume sequence 
numbers and, where necessary, with continuation markers. 

Note 

You cannot use more than 99 diskettes for one data 
set. If you attempt to use more, FLINT displays the 
error message: 

?Maximum number of volumes exceeded 
FLINT then displays the # prompt. 

If no fatal errors occur, on completing the RSTS/E-to-IBM transfer, 
FLINT displays this message: 

Exchange Completed 

data set name Resides on x Diskettes 
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where: 

data set name indicates the name of the data set 

x indicates the number of diskettes that comprise the 

named data set. 


Initializing and Erasing a Diskette 

Type /ZERO in response to the # prompt to begin the dialogue for 
initializing the directory of a single density diskette. In the 
following dialogue description, explanations follow FLINT'S questions. 

Zero which diskette? 

This question asks you to specify the location of the diskette whose 
directory you want to initialize. The drive specification has the 
format: 

DXn: 

or 

n 

where DXn specifies the location of the diskette and n is a device 
number in the range zero to seven. 

Really Zero DXn: <No>? 

FLINT asks this question to make sure that you specify the correct 
diskette. DXn: indicates the diskette.you want to initialize. If you 
answer YES or Y to this question, FLINT initializes the directory of 
the diskette. If you accept the default by pressing RETURN, FLINT 
displays a message, followed by the # prompt. 

Type /ERASE in response to the # prompt to begin the dialogue for 
erasing a single density diskette. In the following dialogue 
description, explanations follow FLINT'S questions. 

Erase which diskette? 

This question asks you to specify the diskette drive of the data set 
you want to erase. The drive specification has the format: 

DXn: 

or 

n 

\ 

Where DXn specifies the diskette drive and n is a number in the range 
zero to seven. 
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Really Erase DXn: <No>? 

FLINT asks this question to make sure that you specify the correct 
diskette. DXn: indicates the diskette you want to erase. If you 
answer YES or Y to this question, FLINT initializes the directory of 
the diskette and overwrites all data with zeros. This operation can 
take considerable time. If you accept the <N0> default by pressing 
RETURN, FLINT displays a message, followed by the # prompt. 


FLINT Dialogue Examples: /DIRECTORY, /TORSTS, /TOIBM, /ZERO, and 
/ERASE 

In the first example, FLINT displays the directory listing of an IBM 
diskette on your terminal: 

$ RUN AUXLIB$:FLINT 

FLINT V9.0 RSTS V9.0 

#/DIR 

Output to? 

Directory of? DXO: 

DIRECTORY OF DXO: 


DSN 

BRL 

BOE 

EOE 

EOD 

BI 

MVI 

VSN 

XFILEXMA 

128 

01001 

30011 

30012 




WUMPUSDB 

080 

30012 

43019 

43020 




PHONE DB 

128 

43020 

47003 

47004 





Total of 3 Data Sets on DXO: 

In the next example, FLINT transfers data from an ItM diskette to a 
RSTS/E disk file: 

$ RUN AUXLIB$:FLINT 
FLINT V9.0 RSTS V9.0 
#/TORS 

Output to? PHONE.DAT 

Translate from EBCDIC to ASCII <Yes>? <RET> 

Input from? DXO:PHONE DB 

DXO: 

4 128 Character IBM Records - 1 RSTS Record 

Exchange Completed 

88 IBM Records Read 

89 Logical ( 23 Physical ) RSTS Records Written 
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In this /TORSTS dialogue, FLINT transfers data set PHONE DB from 
diskette DXO: to the RSTS/E output file PHONE.DAT. By default, FLINT 
translates the data into ASCII. FLINT computes and displays the 
blocking factor (4 IBM records to 1 RSTS/E record). 

In the next example, FLINT transfers a RSTS/E disk file to an IBM 
diskette: 

$ RUN AUXLIB$:FLINT 

FLINT V9.0 RSTS V9.0 

#/TOIBM 

Output to? DXl:MYDATA 

Translate from ASCII to EBCDIC <Yes>? <RET> 

Input from? MYDATA.DAT 
Record Length <128>? 

1 RSTS Record = 4 IBM Records 

Exchange Completed 

MYDATA Resides ON 1 Diskette 

In this /TOIBM dialogue, FLINT transfers the RSTS/E file MYDATA.DAT to 
the IBM data set MYDATA on diskette DXl:. By default, FLINT 
translates the data to EBCDIC. FLINT computes and displays the 
blocking factor (1 RSTS/E record to 4 IBM records). 

The last example uses the /ZERO operation to initialize the directory 
of a diskette on unit 0 (DXO:), and the /ERASE operation to initialize 
and erase a diskette on unit 1 (DXl:): 

$ RUN AUXLIBS:FLINT 
FLINT V9.0 RSTS V9.0 
#/ZER 

ZERO which diskette? 0 
Really ZERO DXO: <No> ? Y 
#/ERA 

ERASE which diskette? 1 
Really ERASE DXl: <No> ? Y 
# <CTRL/Z> 

$ 


2-65 



System Utilities 
FLINT 


FLINT Error Messages 

FLINT displays both fatal and nonfatal error messages. If the error 
is nonfatal, FLINT repeats the prompting question. If the error is 
fatal, FLINT aborts the transfer. See the RSTS/E System User's Guide 
for a list of error messages specific to RSTS/E. 

Table 2-12 lists the FLINT error messages and their meanings. 

Table 2-12: FLINT Error Messages 


Message and Meaning 


Recoverable Errors 


?DATA SET NAME TOO LONG 

The IBM data set you specified name has more than eight 
characters, including spaces and tabs. 

?DATA SET NOT FOUND 

FLINT cannot find on the current diskette the data set you 
specified. 

?ILLEGAL DATA SET NAME 

You specified a data set name where none is permissible. 

?ILLEGAL FILE NAME 

The file name you specified contains unacceptable characters or 
violates the specification format. 

?ILLEGAL PPN 

You specified wildcards in the account number, or you typed an 
account number that does not exist. 

?LOGICAL DEVICE NAME NOT ASSIGNED 

You specified a logical device name that was not previously 
assigned. 

’OUTPUT DEVICE MUST BE DISK 

In a /TORSTS transfer, you specified an output device other 
than a RSTS/E disk (the only permissible type). 

7V0LUME #[m] CANNOT FOLLOW VOLUME #(n] 

In a multivolume /TORSTS transfer, you specified an input 
volume number [m] that is not one greater than the previous 
volume number [n] you specified. 
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Table 2-12: FLINT Error Messages (Cont.) 

. . + 

I Message and Meaning | 

. .. 

I Nonrecoverable Errors | 

... 

j ?BOE * EOD - TRANSFER ABORTED 

In the specified data set, the Beginning Of Extent address is 
| the same as the End Of Data address; that is, the data set has 
| no length. j 

! i 

| ?DATA SET LABEL MUST BE HDRl - TRANSFER ABORTED j 

The label ID of a data set you specified is not HDRl, which IBM | 

| format requires. 

I ?TRACK 00 DOES NOT CONTAIN ERMAP FIELD - TRANSFER ABORTED 
There is no ERMAP field in track 00 of the diskette you 
| specified; according to IBM format, this field must be present. | 
....+ 
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Communicating with the System Manager: The GRIPE Program 

The GRIPE program sends messages to the system manager. GRIPE writes 
your comments to a common file where they are held for system manager 
review. 


Privilege Required 

You do not need any special privilege to run the GRIPE program and 
send a message to the system manager. You do, however, need WACNT 
privilege to use the *LIST and *RESET commands. 


Sending a Message 
To run GRIPE, type: 

$ RUN AUXLIB$:GRIPE 

GRIPE displays an identifying header, followed by a $ prompt to 
indicate that it is ready to accept comments: 

GRIPE 9.0 RSTS 9.0 

Enter message below (<CTRL/Z> to end): 

(♦LIST to list gripes, *RESET to reset file) 

Message:Jack: 

Message:Please request that all users return the system 
Message:line printer ON LINE after removing-their printout. 
Message:Thanks, Ann 
Message: <CTRL/Z> 

Your message has been recorded 
$ 

Following the Message: prompt, type the text of your comment, which 
GRIPE enters into the common file. End all text lines by pressing 
RETURN. If you end a text line by entering CTRL/Z, GRIPE exits and 
you lose the last line of text. 

GRIPE indicates its acceptance of the text and its termination by 
displaying the message: 

Your message has been recorded 
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When you end your message, GRIPE attempts to open comment file 
GRIPE.TXT with write access. If another user already has the file 
open with write access, GRIPE displays the warning message: 

IGRIPE file in use - please wait... 

GRIPE tries to open the file every 5 seconds up to a limit of 60 
seconds. If GRIPE can open the file with write access within the time 
limit, GRIPE writes your message to the file and displays the Thank 
You message. If GRIPE cannot open the file within the time limit, 
GRIPE displays the error message: 

?Unable to write to GRIPE file 
PPlease try again later 

If comment file GRIPE.TXT does not have enough free space to store 
your message, GRIPE displays the error message: 

?GRIPE file is full 

?Please notify system manager 


The *LIST Command 

The following section shows how to display the contents of the 
GRIPE.TXT file using the *LIST command. You can: 

o Display the messages on your terminal 

o Send the messages to a line printer 

o Write the messages to a file 

Each comment in the GRIPE.TXT file consists of: 

o An identification line, which contains: 

Project-programmer number (PPN) of the user 

. - Account name or (no name) of the user 

Terminal keyboard number of the user 

The date and time the message was entered 

o The comment text 
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An example using the *LIST command is: 

$ RUN AUXLIB$:GRIPE 
GRIPE V9.0 RSTS V9.0 

Enter message below (<CTRL/Z> to end): 

(*LIST to list gripes, *RESET to reset file) 

Message: *LIST 

Output to <_KB:GRIPE.LOO? 

*** From user [1,214] (Hogan) on KBl: 31-Jan-85 04:01 PM *** 

Jack: 

Please request that all users return the system 
line printer ON LINE after removing their printout. 

Thanks, Ann 
$ 

After GRIPE displays the Message: prompt, type *LIST and press RETURN. 
You must include the leading asterisk (*); otherwise, GRIPE interprets 
the command as a comment line. 

If file GRIPE.TXT is empty, GRIPE displays the informational message: 
No GRIPES found 

GRIPE THEN exits to your keyboard monitor. Otherwise, GRIPE displays 
the prompt: 

Output to <_KB:GRIPE.LOO 

Press RETURN to display the comments on your terminal or type a line 
printer device or a file specification. 

If the GRIPE.TXT file is more than 90 percent full, GRIPE displays the 
warning message: 

%GRIPE file almost full - 
please *RESET it. 
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The *RESET Command 

The following section shows how to delete the GRIPE.TXT file using the 
♦RESET command. 

An example using the *RESET command is: 

$ RUN AUXLIB$:GRIPE 
GRIPE V9.0_ RSTS V9.0 

Enter message below (<CTRL/Z> to end): 

(♦LIST to list gripes, *RESET to reset file) 

Message: *RESET 
GRIPE file reset 
Message: <CTRL/Z> 

$ 

After GRIPE displays the Message: prompt, type *RESET and press 
RETURN. You must include the leading asterisk; (*) otherwise, GRIPE 
interprets the command as a comment line. After deleting the file, 
GRIPE returns you to your keyboard monitor. 
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GRIPE Error Messages 

Table 2-13 lists and describes the GRIPE error messages. 
Table 2-13: GRIPE Error Messages 


Message and Meaning 



?GRIPE FILE IS FULL 

PLEASE NOTIFY SYSTEM MANAGER 


The GRIPE text file is full. List the file and then RESET it. 
??PROGRAM FAILURE IN GRIPE 

There has been an unexpected failure in the GRIPE program. 

TUNABLE TO CREATE GRIPE FILE 

Cannot create the GRIPE text file. 

TUNABLE TO OPEN GRIPE FILE 

Cannot open the GRIPE text file. 

TUNABLE TO OPEN OUTPUT FILE <file name> 

Cannot open the specified output file or device to list or 
store GRIPE text. 

TUNABLE TO RESET GRIPE FILE 

Cannot reset the GRIPE text file. 

TUNABLE TO WRITE TO GRIPE FILE 
PLEASE TRY AGAIN LATER 

Cannot gain write access to the GRIPE text file. 

TWACNT PRIVILEGE REQUIRED 

You must have WACNT privilege to list and reset the GRIPE text 
f ile. 
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Obtaining Helps The HELP Program 

The system library program HELP contains files that describe other 
system programs and system resource commands. HELP is an interactive 
program that prompts you for topics, subtopics, and sub-subtopics. To 
obtain information on system programs or commands, you type the 
desired topic, and optional subtopic and sub-subtopic in response to 
the HELP prompts. Your response directs HELP to display the specified 
information. 


Privilege Required 

To run the HELP program and use its various features, you need 
Create/Rename access to any file you create using the /OUTPUT switch. 


Running the HELP Program 

To run HELP, type: 

$ RUN HELP$:HELP 

HELP then displays a header and prompts you for the desired topic. 

For example: 

HELP V9.0 RSTS V9.0 

Topic? 

In response to the prompt, type or press one of the following: 

\ 

o The name of the topic about which you want information. If 
you abbreviate the name, HELP displays information on all 
topics that match the abbreviation. In addition to the topic 
you can specify one or more subtopics (separated by spaces) 
associated with that topic. The level to which you can nest 
subtopics depends on the particular topic about which you 
want information. 

o A * wildcard character, which directs HELP to display 
information on all available topics. 

o The ? character, which directs HELP to display a list of 
available topics. 
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For example: 

Topic? 

Help is available on: 

/OUTPUT /PROMPT 

ADVANCED ASSIGN ATTACH BASIC BYE 


Topic? 

To exit from the HELP program, enter CTRL/Z at any prompt. You can 
also exit HELP by pressing RETURN at the Topic? prompt. 

If any level of HELP text contains more than 24 lines, HELP displays 
24 lines and displays the prompt: 

Press RETURN for more... 

If you type any characters at this prompt, HELP ignores them and does 
not echo them on your terminal. HELP waits for you to press RETURN, 
or enter CTRL/Z to exit. HELP continues this process as long as there 
is more text to display. 
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HELP describes many of the topics by displaying additional subtopics. 
Depending on the particular topic, HELP may provide several layers of 
subtopics. The prompt for subtopics contains the original topic name 
and all subtopic names down to the current subtopic name. If. there 
are no further subtopic layers, HELP prompts at tfce final subtopic 
layer. For example: 

Topic? SYSTAT 

SYSTAT 

The SYSTAT program provides current system information. It may be 
run with the command RUN $SYSTAT or invoked with the CCL command, 


Additional help is available on: 

/A /B /c /D 


SYSTAT Subtopic? WHO 
SYSTAT 
WHO 

The "Who" column in the job status report gives the account under 
which the job is running. This column will contain one of the 
following: 


SYSTAT Subtopic? <RET> 

Topic? <RET> 

$ 


2-75 



System Utilities 
HELP 


Each time you press RETURN at the Subtopic ? prompt, HELP displays the 
next higher subtopic level until it reaches the the top Topic? prompt. 
If you press RETURN at this prompt, HELP exits. 

If you specify a HELP topic that does not exist, HELP displays the 
list of available topics, followed by the Topic? prompt. 


HELP as a CCL Command 

Your system manager can define a CCL HELP command on your system. If 
the CCL HELP command name conflicts with the DCL HELP command, use the 
CCL prefix when you type the CCL command. The examples in this 
section assume that the CCL command is HELP and include the CCL 
prefix. 

You can use CCL HELP with prompting or without prompting. To direct 
HELP to include prompting, include the /PROMPT switch immediately 
after the CCL HELP command. You can abbreviate the switch to /P. You 
cannot use the /P switch if you include the /OUTPUT switch (see the 
next section for a description of the /OUTPUT switch). When you 
include the /P switch, HELP displays descriptive text about how to use 
HELP, displays a list of available HELP topics, and displays a prompt. 

For example: 

$ CCL HELP/P 
HELP V9.0 RSTS V9.0 

Help can be obtained on a particular topic by typing: 

HELP topic subtopic subsubtopic ... 

A topic can have the following format: 

1) an alphanumeric string (e.g., a command name, option, etc.) 


Topic? 

From this point on, CCL HELP with prompting functions the same way as 
it does when you use the RUN HELP?:HELP command. 
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When you include the /P switch, you can also specify a topic and 
optional subtopics in the command line. In this case, HELP displays 
the information and displays the topic name Subtopic? prompt if there 
are subtopics. If there are no subtopics, HELP displays the Topic? 
prompt. For example: 

$ CCL HELP/P PIP SWITCHES /IN 

PIP 

SWITCHES 

/IN 

/Q 


Inspects eligible files; type 'Y' to transfer or 
anything not beginning with 'Y' to omit. Type 


Topic? 

If you do not include the /P switch but do include a topic and 
optional subtopics in the CCL command line, HELP displays the 
information and exits. For example: 

$ CCL HELP QUE 

QUE 

The QUE program creates requests, or jobs, to be executed by 
spooling programs. QUE can also list, modify, or kill pending 
requests. 


$ 
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By default, CCL HELP displays the HELP text on your terminal. If you 
want to write the text to an output file, specify the /OUTPUT: switch. 
You can abbreviate the switch to /O:. If you include the /O: switch, 
you cannot include the /P switch. Immediately after the colon (:), 
specify the output file specification, a space, the topic, and 
optional subtopics. If you do not include a file type, HELP uses a 
default file type of .LST. HELP does not display the HELP text on 
your terminal. For example: 

$ CCL HELP/O:SYSHLP.SAV SYSTAT 

$ 
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Manipulating Address Space Locations: The ODT Program 

The ODT (Octal Debugging Tool) program opens a file, a peripheral 
device, or memory as an address space and allows you to examine and 
change word or byte locations within that address space. You can also 
list the contents of certain table locations in the operating system. 

Privilege Required 

To run the ODT program and use its various features, you need the 
following: 

o RDMEM privilege to read memory 

o RDMEM and SYSMOD privileges to read and change memory 
o RDWFS privilege to read a non-file - structured device 
o WRTWFS privilege to write to a non-file-structured device 
o Read access to read a file 

o Read and write access to read and change a file 


How ODT Works 

The ODT program immediately interprets and executes each character as 
you type it. This interpretive mode is called ODT submode or no 
delimiter character input mode and differs from the procedure other 
utilities use. Other programs interpret input only after you enter an 
entire line of characters. Because ODT performs processing based on 
single characters typed at the terminal, its language is highly 
interpretive and interactive. 

Note 

ODT was designed for expert system programmers having 
a thorough knowledge of file formats and operating 
system tables. Use extreme care with ODT; mistakes 
can cause data loss or corruption. 

The program accesses and manipulates data in word and byte locations 
based on octal values. The word is the 16-bit PDP-11 word and can 
have an octal value in the range of 0 to 177777, the maximum value 
obtainable with 16 bits. A word has high-order (odd address) and 
low-order (even address) bytes. A byte can have an octal value in the 
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range of 0 to 377, the maximum value obtainable with 8 bits. The 
following symbols express the octal values that ODT prints: 

Symbol Meaning 


n 

Represents an octal integer between 0 and 17. The use of 

8 or 9 generates an error. 

k 

Represents an octal value up to 6 digits in length. If you 
specify more than six digits or a value greater than 177777 
(octal), ODT truncates the value to the low order 
(rightmost) 16 bits. If a minus sign (-) precedes the octal 
value, ODT uses the two's complement value of the number. 


For example, ODT interprets the following values as shown: 


Value 

Interpretation 

1 

000001 

-1 

177777 (two's complement) 

400 

000400 

-177730 

000050 (two's complement) 

1234567 

034567 (truncated to low-order 16-bits) 


You can represent a location within the permissible address space by 
typing an octal value or an expression that evaluates to an octal 
value. The correct forms and their interpretations are: 


Symbol 

Meaning 

k 

The six-digit octal value of k. 

n,k 

The resultant address is the value of k added to the contents 
of the relocation register specified by n. Relocation 
registers are numbered from 0 to 17 (octal). 
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Table 2-14 lists the special 
recognizes. 


characters and symbols that ODT 


Table 2-14: ODT Characters and Symbols 


... 

I Character | 

I Symbols 

... 


.. 

Meaning 


/ 

k/ 


k ' 


k" 


% 

k% 


<RET> 

k<RET> 


<LF> 

k<LF> 


@ 

k@ 


I Opens the previously open location as a word, or 
opens the location designated by k as a word. 


Opens the previously open location as a byte, or 
opens the location designated by k as a byte. 

Gives the ASCII representation of the currently 
I open or last open location, or of the location 
I specified by k. 

I 

I Gives the ASCII representation of the Radix-50 
value in the currently open or last open location, 

I or in the location specified by k. 

I Closes the currently open location, or modifies 
the contents of k followed by the currently open 
location with the value k and closes it. 

I Closes the currently open location and opens the 
next sequential location, or modifies the contents 
of the currently open location with the value of k 
before closing it and opening the next sequential 
I location. 

| Closes the currently open location and opens the 
| preceding sequential location. 

I 

I Takes the contents of the currently open location 
I as a program counter relative offset and 
I calculates the next location to be opened; closes 
the currently open location and opens the location 
| thus evaluated. 

I 

Takes the contents of the currently open location 
as an absolute address, closes the currently open | 
location; opens and prints the contents of the 
| location thus evaluated, if k precedes @, the 
| value k replaces the contents of the currently 
| open location before it is closed. i 
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Table 2-14: ODT Characters and Symbols (Cont.) 



> 

k> 


space bar 


R 

nR 

k;nR 

F 

IF 


Takes the low order byte of the currently open 
location as a relative branch offset and 
calculates the address of the next location to be 
opened. Closes the currently open location and 
opens and prints the contents of the relative 
branch location thus evaluated. If k precedes >/ 
the value k replaces the contents of the currently 
open location before it is closed. 

Closes the currently open location and opens the 
last location explicitly open. Returns ODT to the 
origin of a sequence of relative locations 
determined by and > character operations. 

Separates a relocation register number from an 
octal value. ODT adds the contents of the 
specified relocation register to the octal value 
following the comma, and forms a relocatable 
address. 

Separates multiple values in a list request using 
the L character and in a register operation using 
the R character. 

Specifies the last explicitly open location 
similar to that used by the < character. 

Adds the preceding value and following value and 
uses the result. 

Subtracts the following value from the preceding 
value and uses the result. 

Resets all relocation registers to -1 (177777). 

Resets relocation register n to -1 (177777). 

Sets relocation register n to the value k. 

Sets relocation calculation for list requests 
using the L character. 

Disables relocation calculation set by the F 
character. 
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Table 2-14: ODT Characters and Symbols (Cont.) 


Character 

Symbols 


Meaning 


$S 

Q 

kl;k2L 

l;kl;k2L 

2;kl;k2L 


Prints out monitor table symbolic names and memory 
addresses. 

Prints out the processor status word. 

Uses the last quantity printed by ODT. 

Prints the contents of locations kl through k2 at 
the terminal. 

Prints the contents of location kl through k2 on 
line printer unit 0. 

Prints the contents of location kl through k2 on 
another device. ODT asks for a device designator 
by printing the DEVICE question. 


Running and Terminating ODT 
To run ODT, type: 

$ RUN AUXLIB?:ODT 

ODT displays an identification line and the FILE question, and waits 
for your response: 

ODT V9.0 RSTS V9.0 
FILE<MEMORY>? 

Your response to this question determines the way ODT runs and what 
address space ODT accesses. 

Table 2-15 lists the possible responses to the FILE<MEMORY>? prompt. 
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Table 2-15: ODT Question Responses 


+.+ 

| Response | 

+.+ 


.+ 

Meaning | 

.+ 


Press RETURN only. 


Allows read access to memory only 
if you have RDMEM privilege. 


Type a file specification, 
then press RETURN. 


Press LINE FEED only. 


Allows read access to the file on 
the device specified. If you 
specify no device, ODT uses the 
system disk. 

Allows read and write access to 
memory only if you have RDMEM and 
SYSMOD privileges. 


| Type the file specification, | 
j then press LINE FEED. 

+.+ 


Allows read and write access to the | 
file specified. j 
-.+ 


ODT determines the address space by your response to the 
FILE<MEMORY>? prompt. ODT then displays the * prompt, indicating it 
is ready to accept commands. For example: 


FILE<MEMORY>? ABC.DAT 
* 


ODT opens, for read and write access, file ABC.DAT on the system disk 
under the current account. To exit from ODT, enter CTRL/Z in response 
to the * prompt. For example: 

* <CTRL/Z> 

$ 

ODT closes any file currently open and returns control to your 
keyboard monitor. 


Accessing Locations in the Address Space 

Typing the slash (/) character access the address space as a word. 
For example: 

*1000/ 004100 
* 
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In this example, ODT: 

o Opens the location as a word 
o Generates a space 

o prints the six-digit octal contents of the word 
o Generates another space 
o Leaves the location open for change 

To close the location, press RETURN. ODT: 
o Closes the location 
o Displays the * prompt 
o Does not open a new location 

Typing the backslash (\) character opens a location as a byte. 

example: 

* 1000 \ 100 
* 

In this example, ODT: 

o Opens the location as a byte 
o Generates a space 

o Displays the six-digit octal contents of the byte 
o Generates another space 
o Leaves the location open for change 

To close the location, press RETURN. ODT: 
o Closes the location 
o Displays the * prompt 
o Does not open a new location 


For 
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To change location 1000, type a new six-digit octal value and press 
the RETURN key. For example, if location 1000 is open as a word: 

*1000/ 004100 004000 

* 

In this example, ODT: 

o Replaces the current contents (octal 004100) with 004000 
o Closes the location 
o Displays the * prompt 

Typing the slash (/) character at the * prompt displays the contents 
of the current word location. For example, if the current location is 
1000 : 

*/ 004000 

In this example, ODT: 

o Opens the current location 
o Generates a space 
o Displays the six-digit contents 
o Generates another space 

If you press LINE FEED while a word location is open, ODT opens the 
next sequential location. For example, if location 1000 is open and 
you press LINE FEED: 

*1000/ 004000<LF> 

•001002/ 012345 

In this example, ODT: 

o Closes the current location 

o Generates a carriage return and line feed 

o Opens the next sequential location 

o Prints the address of the next location 

o Displays a slash (/) and space 

o Displays the contents of the word 
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If you press LINE FEED while a byte location is open, ODT performs the 
same actions as for a word location, except that the next location is 
treated as a byte. 


Opening the Preceding Location 

Typing a circumflex (*) character when a location is open causes ODT 
to close the location currently open and to open the location 
immediately preceding the one just closed. 

For example, if you open two sequential locations in succession and 
then type the * character, ODT closes the last location open and opens 
the location you opened first. For example: 

*1000/ 002345<LF> 

001002/ 012740* 

001000/ 002345 

In this example, ODT: 

o Closes location 1002 

o Opens location 1000 

o Displays the contents of location 1000 

If you type a value followed by the * character, ODT replaces the 
current contents with the specified value before closing the location. 

If you type the * character and a location is not currently open, ODT 
opens and prints the contents of the word or byte location that was 
last open. For example: 

*1000/ 002345 

001000/ 002345 

In this example, ODT: 

o Displays the address of the location that was open last 
o Displays the contents of word location 1000 
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Opening a PC Relative Location 

If you type the underscore (_) character when a location is currently 
open, ODT: 

o Closes the currently open location 

o Adds 2 to the address of the location just closed 

o Adds the resultant address sum to the contents of the 
location just closed 

o Opens the location specified by the contents of the location 
just closed 

o Displays the contents of the currently open location 

For example: 

*1000/ 000040_ 

001042/ 012345 

In this example, ODT: 

o Closes location 1000 

o Adds 2 to the address (1000) 

o Adds the resultant sum (1002) to the contents (40) of 
location 1000 

o Opens location 1042 and prints its contents (12345) 

This method of calculating the next location to open is similar to 
that used in relative addressing by the PC in the PDP-11 computer. 

Note that this method of address calculation is for 
position-independent code. 

If the contents of the current location is an odd value, ODT opens and 
prints the contents of the low-order byte of the PC relative location. 
If you type a value followed by an underscore character, ODT modifies 
the current contents and uses the new value to calculate the PC 
relative address. 
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Opening an Absolute Location 

Typing the at sign (@) character when a location is currently open 
causes ODT to use the contents of the current location as the address 
of the next location to open. As a result, ODT: 

o Closes the current location 

o Opens the calculated location 

o Prints its contents 

For example: 

*1006/ 001024 @ 

001024/ 000500 

In this example, ODT: 

o Opens location 1024 

o Displays the contents 

If you type a value followed by the @ character, ODT changes the 
contents of the current location to the new value and uses this value 
to determine the next location to open. The method is equivalent to 
absolute addressing on the PDP-11 computer, where the contents of the 
location following an instruction is taken as the address of the 
operand. The address is absolute because it remains constant 
regardless of where in memory the assembled instruction is executed. 


Opening a Relative Branch Offset Location 

Typing the greater than (>) character when a location is currently 
open causes ODT to use the signed value of the low-order byte of the 
current location to determine an offset from the current location. As 
a result, ODT: 

o Closes the current location 
o Opens the calculated location 
o Displays the contents of the new location 
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For example: 

*1032/ 000407 > 

001052/ 001456 

In this example, ODT: 

o Multiplies the low-order byte (007) of the contents (000407) 
of the current location by 2, giving a result of 16 (octal) 

o Adds 2 to the address (1032) of the current location, giving 
a result of 1034 

o Sums the results of the two calculations (1034 + 16), giving 
the address (1052) of the next location to open 

o Closes the currently open location 

o Opens the new location and prints its address and contents 


If you specify a value followed by the > character, ODT modifies the 
contents of the currently open location and uses the low order byte of 
the new value to calculate the relative branch offset location. For 
example: 

*1032/ 000407 301> 

000636/ 000010 

In this example, ODT: 

o Interprets byte value 301 as a negative value because its 
high order bit is 1. 

o Multiplies the absolute value of 301 (77 octal) by 2, qivina 
176 (octal) y 

o Subtracts the relative branch offset (176) from the address 
plus 2 of the current location, giving 636 as the address of 
the next location to open. 

o Opens the new location 

o Displays the contents of the new location 
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Returning to an Interrupted Sequence 

Typing the less than (<) character causes ODT to close the currently 
open location and open the last explicitly open location. This 
command is useful when you have typed the @, and > characters, or 
any sequence thereof, and want to open the locations from which ODT 
calculated subsequent relative locations. For example: 

*1032/ 000301 > 

000636/ 000010 @ 

000010/ 123456 < 

001032/ 000301 

In this example, ODT: 

o Opens location 10 after you type the > and @ characters 
o Displays the contents of location 10 

o Opens the last explicitly opened location (1032) after you 
type the < character 

o Displays the contents of location 1032 


Printing the Contents of a Range of Locations 

You can display the contents of a range of locations using the format: 


[device;]start-loc;end-locL 
where: 

device is the number of the device to which you want ODT to 

send the contents. If you do not specify a device, ODT 
displays the contents on your terminal. If you specify 
1, ODT sends the contents to line printer LP0:. If you 
specify a number other than 1, ODT prompts you for the 
line printer device number. If you specify a device 
number, include the semicolon (;). 


start-loc 
end*loc 
L 


is the starting location of the range. 

is the ending location of the range. 

is the letter, which indicates that you want ODT to 
output the contents of a range of locations. 
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To display the contents of locations 0 through 776 on your terminal, 
respond to the * prompt as follows: 


*0;776L 

To print the contents of locations 0 through 776 on line printer LPO:, 
respond to the * prompt as follows: 

*1; 0;776L 

To print the contents of locations 0 through 776 on line printer LP1:, 
respond to the * and DEVICE? prompts as follows: 

*2;0;776 
DEVICE7LP1: 

Enter CTRL/O to turn the display on and off. If ODT is displaying a 
listing and you enter CTRL/O, the display stops; when you enter 
another CTRL/O, the display resumes. 


Printing ASCII Format 

If you type quotation marks (") when a location is currently open, ODT 
prints the ASCII representation of the contents. 

If the current location is open as a byte, ODT prints a single ASCII 
character representing the byte. For example: 

*1000 101 " A 

If the current location is open as a word, ODT. prints, two ASCII 
characters representing the word. For example: 

*1032/ 034567 " w9 

If you type the quotation mark and a location is not currently open, 
ODT prints the ASCII representation of the previously open location. 
For example: 

*1032/ 034567 <LF> 

*« w9 
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Printing Radix*50 Format 

If you type the percent (%) character when a location is currently 
open as a word, ODT prints the three - character ASCII representation of 
the Radix-50 word. For example: 

*1000/ 034567 % IG1 

If you type a value before the % character when a location is 
currently open as a word, ODT interprets the value as the location 
whose contents you want to display. For example: 

* 1032/ 000301 1000% IG1 

If you type the % character and a location is not currently open, ODT 
Points the three - character ASCII representation of the previously open 
location. For example: 

*1032/ 034567 
*% IG1 

* 


Relocation Registers 

ODT has 16 relocation registers that you can use to specify relative 
addresses. ODT initially sets the relocation registers to -1 (177777 
octal), the highest possible address, to prevent inadvertent errors in 
address calculation. To set a relocation register, type the relative 
address, followed by a semicolon and the specification of one of the 
16 relocation registers. For example, to set relocation register .0 to 
1000, type: 

*1000; OR 
* 

You can subsequently use the value in relocation register 0 as an 
offset or a base address in specifying a location. For example, to 
open location 1032 as a word, type: 

*0,32/ 000010 

ODT adds offset 32 to the contents of relocation register 0 to open 
location 1032. 

To reset the contents of all relocation registers to -1 type R in 
response to the * prompt. For example: 

*R 

* 
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To reset the contents of any one register to -1, specify the register 
number followed by R. For example: 

* 1R 

* 

When used with disk files, ODT treats registers 0 through 7 
differently from registers 10 (octal) through 17 (octal). For 
registers 0 through 7, the leftmost three digits specify a block 
number and the rightmost three digits specify a byte location within 
the block. For example, 000017 designates byte 17 in block 0 of the 
file. The value 003412 designates byte 412 in block 3 of the file. 
These registers are helpful in accessing data that is partitioned in 
512-byte blocks. 

For registers 10 through 17, the value specifies an absolute block 
address on the disk file. For example, the value 1000 (octal) 
specifies block 1000 (octal) on the disk file. 

You can use relocation registers 10 through 17 to access blocks in 
large files. That is, files larger than 65K blocks and beyond block 
number 65,535. Each block contains 1000 (octal), 512 (decimal), 
bytes. Using the number stored in one of these registers as a base 
block address, you can then examine the contents of any one of the 
next 177777 (octal) bytes offset from the base base block address. 

This allows you to examine the contents of any byte in the next 128 
(decimal) blocks, referenced from the base block address. To examine 
the contents of a byte offset from a base block address block, you 
must: 

1. Store the base block address in one of the relocation 
registers 10 through 17 

2. Specify the relocation register and the byte offset (in 
octal) in a separate command 

For example: 

*303240;10R 
*10R,30/ 000234 

In the first line, you specify that you want to use block address 
303240 (octal); 100,000 (decimal); as the base block address and store 
this address in relocation register 10. 
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In the second line, you specify you want to examine the contents of 
the byte that is offset from the base block address by 30 (octal); 24 
(decimal); bytes. Depending on the byte offset you specify, ODT 
appends zeros to the least significant end of the base block address. 
Because blocks are comprised of 1000 (octal) bytes, the minimum number 
of zeros appended is three. In this example, the base block address 
is changed to 303240000. ODT then adds the 30-byte offset to 
303240000 to obtain the byte address of 303240030 and displays the 
contents, 234 (octal). 

You can print the contents of locations based on a fixed offset from 
the relocation registers. For example: 

*F 

*1;0;3000L 
* 

The first line instructs ODT to calculate relocated addresses for the 
display. The second line instructs ODT to add offsets from 0 to 3000 
to the value of relocation register 0 and print the contents of those 
locations on line printer 0. You can repeat the procedure for values 
of relocation registers 1 through 7. The printout contains a listing 
of the contents of addresses n,0 through n,3000 where n is in the 
range of 0 to 7 (the relocation registers). 

To turn off calculation of relocation addresses for a printout, type 
IF. For example: 


*1F 

★ 


Subsequent listing requests print out actual-addresses rather than 
relocated addresses. 


Interpretive Address Quantities 

ODT stores the value of the last location value displayed on your 
terminal in a variable named Q. You can request that ODT perform any 
valid arithmetic procedure on Q. For example, if you want to increase 
the value of an open location by a certain increment, type: 

*1342/ 173214 Q+10 
*/ 173224 
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The first line opens location 1342 as a word, displays the value 
173214, and adds 10 to that value stored in variable Q. In the second 
line, you display the current value stored in Q (173224) by typing a 
slash (/). ODT opens location 1342, prints its new contents value, 
and updates the value in Q. 

The period (.) character indicates the currently open or last 
explicitly open location. It indicates the current address for ODT 
operations. This is the same address used by the < character (see the 
section "Returning to an Interrupted Sequence"). In most cases, the 
period character value is the address used by ODT when you type the /, 
\, ", or % characters and press LINE FEED. For example, to open as a 
word a location 16 bytes from the last explicitly open location, type: 

*.+16/ 012345 

ODT adds 16 (octal) to the address given by the character, opens the 
resulting address, and prints its contents. 


Error Procedures 

If you type an invalid or unrecognized character, ODT prints a 
? character, generates a CARRIAGE RETURN and a LINE FEED, and displays 
the * prompt. For example: 

*1008? 

* 

ODT indicates that the character 8 is an error. Retype the number 
correctly. 

If ODT finds an error while performing output to a device, it prints 
the error message %I/0 Error, followed by the * prompt. You must 
correct the device error and type the command again. 
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Device Transfer; The PIP Program 

PIP (Peripheral Interchange Program) is a file transfer and 
maintenance utility that can perform these operations; 

o Copy files from one RSTS/E device to another 

o Concatenate, delete, and rename files 

o Change protection codes and file attribute data 

o Initialize accounts 

o List directories 


Privilege Required 

To run the PIP program, you need the following: 

o Read access to any input files you read 
o Create/Rename access to any output files you create 
o Write access to any output files you write to 
o Create/Rename access to any input files you rename 
o TUNE privilege if you use the /LOCK or /PRIOR switches 
o DEVICE privilege for any.restricted devices you access 

Running the PIP Program 
To run PIP, type: 

$ RUN $PIP 

In response, PIP prints an asterisk * prompt to indicate it is ready 
to accept input. 

If your system manager has defined a CCL command for PIP, you can also 
use it to run the program. If you use the PIP CCL command, you can 
include PIP commands on the same line. 
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To terminate PIP, enter CTRL/Z in response to the PIP * prompt: 

§ PIP 

* <CTRL/Z> 

$ 

A CTRL/Z directs PIP to complete the current operation and exit in an 
orderly fashion. If you enter CTRL/C in response to the * prompt, PIP 
exits but does not complete the current operation. If you enter 
CTRL/C during a PIP operation, PIP halts the operation and displays 
the PIP * prompt. Note that you may lose some data. 


PIP Command Line Specifications 

The PIP command line specifies the actions you want PIP to perform and 
the files involved. PIP accepts a command line of up to 80 characters 
in the following general format: 

[output[/sw]=]input[/sw][,input[/sw],...] 


where: 


output 


specifies an output file specification. 

specifies an input file specification. 

specifies one or more switches to direct the action 
PIP performs on the files. 


input 


/sw 


An output file specification has the format: 


dev:[proj,prog]filename.type/PROT:n 


where: 


dev: 


specifies a device. The default is DK:. Note that 
DK: defaults to the public disk structure (SY:) 
unless you have previously assigned DK: to another 
device. 


[proj,prog] specifies a ppn. The default is your current 

account. 
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filename 


•type 


/PROTrn 


specifies a file name of one to six alphanumeric 
characters. PIP allows you to specify only one 
output file specification. If you omit the file 
name, the default is an * wildcard character; see 
the section "Wildcard Specifications." For 
output-only (non-file-structured) devices such as 
KB:, LP:, and PP:, pip ignores the file name and 
type specifications. 

specifies a file type of one to three alphanumeric 
characters. If you omit the type, the default is an 
* wildcard character see the section "Wildcard 
Specifications." If you specify only the period 
(.), the type is null. 

specifies the file protection code see the 
RSTS/E System User's Guide. If you do not 
specify a protection code, the following rules 
apply: 

o For the executable (64) bit, PIP uses the 
executable bit of the input file if the 
input file has a protection code. (Only 
disk files have a protection code.) If the 
input file comes from some other source, 
for example, magnetic tape, then PIP adds 
the executable bit to the output file 
protection code if the file type for the 
output file indicates that it is 
executable (.BAC, .TSK, .SAV). Otherwise, 
PIP clears the executable bit. 

o PIP recognizes a file type as executable 
by comparing it against the file types in 
the run-time system list at the time. You 
can see the file types in the run-time 
system portion of a SYSTAT report. 

o For bits other than the executable bit, 

PIP uses the user-assigned protection 
code, if there is one. (You can establish 
a protection code with the DCL SET 
PROTECTION/DEFAULT command; see the 
RSTS/E System User's Guide.) If there 
is no user-assigned protection code, PIP 
uses the protection code of the input 
file, if it has one. If it does not 
(for example a magnetic tape file), PIP 
uses the default protection code, normallv 
60. 
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o PIP does not allow you to set the 

privileged bit (128) for an output file 
unless you have SYSIO privilege. If you 
try, PIP does not set the bit and does not 
return an error message. 

If you do not type any output specification, PIP directs output to 
your terminal (KB:). 

An input file specification has the format: 

dev:[proj,prog]filename.type/PROT:n 
where: 


dev: 


•tproj ,prog] 
filename 


.type 


specifies a device. If you omit the device, the 
default is DK: as described for output. If the 
previous input file contains a device 
specification, that device becomes the default 
for the current command line until you override 
it with another specification. 

specifies a PPN as described for output. 

specifies a file name of one- to six-alphanumeric 
characters. PIP allows you to specify up to six 
input file specifications, separated by commas. If 
you omit this specification, the default is an * 
wildcard character; see the section "Wildcard 
Specifications." Note that you must specify an 
input file in a delete operation; see the section 
"File Deletion Switches." For input-only 
(non-file - structured) devices such as KB:, PR:, and 
CR:, the system ignores a file name and type 
specification. 

specifies a file type of one- to three-alphanumeric 
characters as described for output. 


/PROT:n specifies a protection code. PIP ignores input file 

protection codes unless the file is the target of a 
rename operation; see the section "File Rename 
Switch." 

If you do not type any input file specification, PIP displays the 
following error message: 

?No input file 
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A PIP switch specification always begins with a slash (/) character; 
see the section "PIP Switches." When you specify more than one switch 
in the command line, you must separate them using the / character. 

When you omit the switch specification, PIP performs a block mode 
transfer; see the section "Block Switch." 

Both the input and output file specifications can contain the RSTS/E 
file switches /PROTECT, /FILESIZE, /CLUSTERSIZE, /MODE, /RONLY, and 
/POSITION; see the RSTS/E Programming Manual. However, file switches 
must immediately follow the file specification otherwise, PIP returns 
an error message. Also, PIP ignores /CLUSTERSIZE on nondisk output 
file specifications. See the section "PIP Switches" for a description 
of file specification switches and their format. 

If you do not type an input or an output file specification, but press 
the RETURN key in response to an * prompt, PIP displays its current 
version and revision level numbers. 


Wildcard Specifications 

PIP allows you to use the * and ? wildcard characters in input and 
output file specifications. The use of wildcards saves you typing 
time and permits you to designate multiple files in a single file 
specification without the PIP restriction of six maximum input file 
specifications. 


Specify wildcards in the following manner: 


Specification 

FILE.* 

* .TYP 

★ ★ 


Result 

All files with the name - FILE and any type. 
All files with the type .TYP. 

All files. 


FILE.TY? 


All files with the name FILE and .TY 
two characters of the file type. The 
character is any character including 


as the first 
thi rd 
blank. 


FILE??.TYP 


FILE??.T?? 


All files with four- to six - character names, the 
first four of which are FILE, and a file type of 
TYP. 


All files with four- to six-character names, the 
first four of which are FILE, and any type whose 
first character is T. 
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Specification 

AB?.TYP All files with two- to three-character names, the 

first two of which are AB, and a file type of TYP. 

FILE??.* All files with four- to six - character names, the 

first four of which are FILE, and any type. 

*.TY? All files of any name whose type begins with .TY. 

In the absence of an element or elements of the full input or output 
file specification PIP substitutes wildcards for the missing elements; 
see the section "PIP Command Line Specifications." You cannot use 

default input specifications for delete operations_The defaults PIP 

applies to missing elements are: 

Specification Default Meaning 

<RET> *.* All files in the current account 

* *.* All files in the current account 


* 

• 

★ 

• 

All files with null types 
account 

in the current 

• 

*. 

All files with null types 
account 

in the current 

.TYP 

* . TYP 

All files with a file type 
the current account 

of .TYP in 

FILE 

FILE.* 

All files named FILE with 
the current account 

any type in 


You can use the ? wildcard character in output file specifications, 
but if such use causes PIP to try to create a file name with embedded 
spaces, PIP prints the error message "Illegal output filename", ignore 
the request, and proceed to the next input file. See the section 
"File Transfer Operations" for an example. 
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PIP allows you to specify an * wildcard character in a ppn. However, 
if you specify wildcard accounts for input files, the files must be 
resident on disk or magnetic tape. 

Note 

You cannot limit a wildcard designation by including a 
protection code. The protection code is simply 
ignored. The file specification *.*/PROT:40 refers to 
all files in your account, not just those with a 
protection code of 40. 


DCL Command Files in PIP 

PIP allows you to specify a DCL command file in response to its * 
prompt. A DCL command file is a user-created ASCII file that contains 
all of the information PIP needs to perform an operation. You can 
also create DCL command files using an editor; see the RSTS/E Guide to 
Writing Command Procedures. 

You specify a DCL command file to PIP in the following manner: 

@dev:[proj,prog]filename.type 
where: 


@ 


tells PIP that the specified file is a DCL 
command file. 


dev: 


specifies a device.The.default is the public 
structure. 


[proj,prog] 


specifies a PPN. The default is the current 
account. 


filename.type specifies the file name and type for the DCL 

command file. You must specify a file name. The 
default file type is .CMD. 


If a line in the file begins with a semicolon (;), pip interprets the 
line as a comment. 

If the file causes the execution of a /ZE or /IN switch operation, PIP 
displays confirmation questions at your terminal. 
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A DCL command file, in addition to containing PIP commands and file 
specifications, can contain references to other DCL command files. 

This process is called nesting. The number of files you can nest 
depends on the amount of memory available to you. If there is not 
enough memory, PIP displays the following error message: 

?No buffer space for command file 

PIP then halts the operation, and returns to the prompt level. A file 
containing references to nested DCL command files must be resident on 
a file - structured disk. 

Most errors during DCL command file processing cause PIP to return to 
prompt level. On the following errors, however, PIP displays the 
following warning message and continues processing: 

%No files matching <spec> 

where: 

<spec> indicates the file specification. PIP returns this 

message during /DE or /LI operations; see the sections 
"File Deletion Switches," and "Directory Listing 
Switches." 

Pip displays the following message during a /RE operation; see the 
section "File Rename Switch." 

?File or account already exists 

The following command shows the procedure to execute a DCL command 
f ile: 

@ABC 

PIP reads the file named ABC.CMD in the current account on the public 
structure. If you specify KBn: following the at sign (@KB3:, for 
example), PIP reads the specified keyboard for commands. You 
terminate the keyboard command set with a CTRL/Z. 

Because you can use the at sign (@) to designate a logical account 
assignment (see the RSTS/E System User's Guide) and a PIP DCL command, 
placement of the @ character in the PIP command line is important. 

When the command line contains an @ character, PIP scans the line for 
validity as a DCL file command. If PIP finds more than one file 
specification, wildcard file specifications, or a PIP switch, PIP 
assumes that the @ character is a logical account and processes the 
command line accordingly. 
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PIP Switches: An Overview 


You specify the operations that PIP is to perform with one or more 
switch specifications in the command line; see the section "PIP 
Command Line Specifications." Always precede a switch with a slash (/) 
character, and separate multiple switch specifications by slashes. 

Table 2-16 lists the PIP switches, their format, and the operations 
that they perform. See the section "PIP Switches" for a detailed 


description 

of their use. 


Table 2-16: 

+.. 

PIP Switches 


| Switch 

- 4 -.. 

| Format 

I Meaning 

1 Informational Switches 

i Help 

+ ......... 

1 

I/HE 

! 

1 

1 

1 

|PIP prints a text message at your 
|terminal that describes file 
(specifications, switches, and 
j options. 

+. 

File 

Transfer Switches 


none 

Access 


Append 

Extend 


ASCII 


Block 


<RET> 

/AC 


/AP or 
/EX 


/AS 


/BL 


See the description of /BL. 

For disk input only, PIP changes 
the file's last access date to the 
current date. If you do not 
specify this switch, PIP preserves 
the last access date. 

For disk output only, PIP appends 
the input file to the output file 
(extends the output file). If no 
output file exists, PIP displays a 
warning message and creates the 
file. 

Formatted ASCII transfer; PIP 
discards nulls, parity bits, and 
rubout characters. 

PIP performs a block-by-block 
transfer with no data translation. 
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Table 2*16: PIP Switches (Cont.) 


+ 

I 

+ 

I 

+ 


+.+ 


Switch 

| Format 

| Meaning 


File 

Transfer Switches 


1 

1 

Block size 

1 

|/BSIZE:n 

1 

1 

1 

1 

1 

|For magnetic tape output only. PIP 
(uses the physical blocksize 
|specified by n (in bytes) for data 

jwritten to the tape. 

1 

Cluster size 

1 

|/CL:n 

1 

1 

1 

1 

i 

|For disk only, PIP sets the output 
jfile cluster size to n. To have 
jeffect, you must place this switch 
|adjacent to the output file 
j specification. For an explanation 
jof cluster size, see the RSTS/E 
j Programming Manual. If you omit 
jthis switch from a disk-to-disk 
jtransfer, PIP preserves the 
|current cluster size. 

| 

Ignore 

Go 

1 

|/IG or 

I/GO 

i 

1 

|PIP ignores ?Data error on device 

j errors. 

1 

Mode 

1 

|/MO:n 

. 

1 

1 

1 

1 

| Sets the mode (n) in which PIP 
j opens the file. To have effect, 
jyou must place this switch 
jadjacent to the file 
j specification; see the RSTS/E 
j Programming Manual for an 
jexplanation of modes. 

New file 

|/NE 

1 

1 

|For disk output only, PIP creates 
ja new file with the current date 
jof creation and access. 

Retain 

1 

|/RET 

i 

i 

1 

1 

|For disk output only, PIP retains 
jcreation and access date of the 
jinput file. 

i 

No attributes 

1 

| /NOA 

i 

i 

l 

|PIP transfers the file without 
jwriting attributes to the output 
|file. 


+ 

I 

+ 

I 

+ 
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Table 2*16: PIP Switches (Cont.) 


Switch 

| Format 

| Meaning 


File 

Transfer Switches 


1 

1 

No supersede 

1 

l/NOS 

|/NOS:NOWARN 
1/NOS:Q 
|/NOS:IN 

1 

1 

1 

1 

1 

i 

i 

1 

IPIP displays an error message and 
|ignores the operation if an output 
|file already exists. If you 
jinclude the :NOWARN option, PIP 
jdoes not display the error 
jmessage. The :Q and :IN options 
|are synonymous. They cause PIP to 
jdisplay the question "OK to 
jreplace file filespec?" if the 
joutput file already exists. Type 
jY, YE, or YES to replace the file. 

Protect 

!/PR 

|/PR:NOWARN 
|/PR:Q 
j/PR:IN 

l 

1 

|Same as NOS. DIGITAL recommends 
|NOS to avoid conflict with 
jprotection code option. 

1 

i 

Run-time 

system 

|/RTS:name 

1 

1 

1 

1 

1 

1 

1 

|Sets the output file's run-time 
jsystem name to that specified in 
jname. If you omit the output file 
jspecification, PIP renames the 
jinput file's run-time system; see 
jthe section "Run-Time System Name 

I Switch." 

I 

Update 

|/UP 

1 

1 

1 

|PIP opens a preexisting disk file 
land overwrites the existing data, 
jlf no file exists, PIP creates a 
jnew one. 

Files 

with Attributes 

, Translation Switches and Options 



1 

RMS 

1 

l/RMS 

1 

1 

I 

|For input disk files, PIP 
jtranslates RMS format to formatted 
|ASCII or formatted binary. 

i 


1 

1 

1 

1 

1 

|For output disk files, PIP 
jtranslates formatted ASCII or 
jformatted binary to RMS variable 
jlength records. 
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Table 2*16: PIP Switches (Cont.) 


Switch 

| Format 

| Meaning 

Files 

with Attributes 

, Translation Switches and Options 


1 

1 


1 

1 

1 

1 

1 

1 

|For nondisk transfers, PIP's 
(translation depends on current 
|format; see the section "File 
(Operations Involving Attributes." 


1 

1 

1 

* 

1 

1 

i 

1 

I 

|If you do not specify the /RMS 
jswitch for disk files, PIP 
jperforms no translation. You 
jcannot apply the switch to both 
jinput and output files in the same 

jcommand line. 

1 


l 

|/RMS:FA 

1 

1 

l 

|For input or output files, 
(specifies formatted ASCII in the 
|translation. 

| 


|/RMS:FB 

1 

1 

|For input or output files, 
(specifies formatted binary in the 

j translation. 

1 


1 

|/RMS:FTN 

1 

1 

1 

1 

|For input files, PIP translates 
|FORTRAN carriage control to 
(formatted ASCII. For nondisk 
joutput files, translation is 
(automatic. 

i 


1 

|/RMS:IM 

1 

1 

1 

|For input files only, PIP performs 
j the same as /RMS but does not 
jtransfer attributes but does 
j remove RMS variable length header 
jinformation. 


1 

|/RMS:PRN 

1 

1 

|For input disk files, PIP 
(translates RMS print files to 
(formatted ASCII. 

Date Switches 


After |/AF:dd-mmm-yy |PIP includes only files that were 

j jcreated after, but not on, the 

I jgiven date. 
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Table 2*16: PIP Switches (Cont.) 


+ . 

| Switch 

| Format 

| Meaning | 

1 Date Switches | 

1 

| Before 

1 

1 

|/BE:dd-mmm-yy 

1 

1 

1 1 

|PIP includes only files that were | 

|created before, but not on, the | 

|given date. | 

l i 

| On 

1 

1 

|/ON:dd-mmm-yy 

1 

|PIP includes only files that were | 

|created on the given date. 

i i 

1 

| Since 

1 

1 

1 

l 

|/SIN:dd-mmm-yy 

1 

1 

1 1 

|PIP includes only files that were | 

|created on or after the given | 

j date. | 

1 1 

l 

| Today 

1 

i 

|/TO 

1 

1 

1 

|PIP includes only files that were j 
jcreated on the current date. | 

I 

| Until 

1 

1 

i 

1 

|/UN:dd-mmm-yy 

1 

1 

1 

1 

|PIP includes only files that were | 

|created on or before the given 

I date. | 

1 | 

I 

| Date of 
j last access 

l 

1 

l/DLA 

i 

i 

|For disk only, PIP uses the date | 

jof last access in file operations, j 

i i 

i 

| Creation 

1 

i 

l/CRE 

1 

1 

|PIP uses the date of creation in | 

|file operations. j 


File Operation 

Switches - General | 

1 

1 

1 r 

1 

| Halt 

1 

1 

i 

l/HA 

1 

1 

I 

1 

|PIP halts a magnetic tape wildcard | 
jsearch as soon as it detects a 

jfile that does not match. | 

1 | 

l 

| Inspect 
| Query 

1 

1 

1 

1 

! 

1 

1 

|/IN or 
l/QU 

1 

f 

1 

1 

1 

1 

|PIP displays one-at-a-time, the | 

|file specifications that match a | 

jwildcard specification. If used in j 
| transfer or /DE operations, as i 

leach file specificatiop is j 

jdisplayed, type Y (for Yes) to 
|transfer or delete; type any other j 
jcharacter to omit. Enter CTRL/Z to | 
lend the display and operation. 
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Table 2-16: PIP Switches (Cont.) 


Switch 

| Format 

| Meaning 


File Operation 

Switches - General 


1 

1 


1 

|/IN:S 

1 

1 

1 

|PIP prints file name, type, 
jfilesize, protection code, 
jcreation date, and last access 

j date. 

1 

Log 

Watch 

1 

|/LO or 
l/WA 

1 

i 

1 

|PIP displays a report on all 
|actions taken during execution. 

IPIP prints the report at your 
|terminal. 

No log 

1 

|/NOLO 

1 

1 

1 

|PIP displays nothing for actions 

|taken during execution. 

1 

No rewind 

1 

|/NO or 
j/RW:NO 

1 

|PIP does not rewind the magnetic 
jtape before an input file search. 

Version 

Identify 

1 

|/VE or 
|/ID 

|PIP displays the program's current 
|version number. 


File Operation 

Switches - Deletion 

Delete 

1 

|/DE 

1 

1 

1 

|For disk and DECtape only, PIP 
jdeletes the specified file. 


1 

|/DE:NO 

1 

1 

1 

|PIP does not display an error 
jmessage if the file to be deleted 

jdoes not exist. 

1 

Erase 

Wipe out 

|/ER or 

I/WIPE or 
|/WO 

1 

1 

1 

|For disk, PIP overwrites the file 
jwith zeros prior to deletion. 

|These switches are synonymous; you 
|must use one of them in 
jconjunction with the /DE switch. 

File Operation Switch - Rename 

Rename 

1 

|/RE:option 

1 

|For disk and DECtape only, PIP 


|renames the input file to that of 
j the output file• 
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Table 2*16: 


PIP Switches (Cont.) 


c 


+ 

! 

+ 

I 

+ 


+ 

I 

+ 


i 

i 


+ 

+ 



Switch 

| Format 

| Meaning 


File Operation 

Switches - Listing 


1 

| 

Brief 

Fast 

1 

|/BR or 

|/F 

l 

|PIP displays a brief directory 

|listing. 

1 

Directory 

List 

Slow 

1 

|/DI or 
|/LI or 

l/s 

1 

|PIP displays a full directory 
|listing. The listing switches 
|accept option specifications that 


modify the directory listing; see 
the section "Directory Listing 
Switches." 


+.+. 

File Operation Switches - Zeroing 



| 

1 

Zero 

l/ZE 

1 

1 

1 

1 

1 

|PIP zeros (initializes) the 
Idirectory of an account or device 
jor initializes the labels on a 
jmagnetic tape. 

i 

Density 

|/ZE/DEN:n 

1 

1 

l 

|For magnetic tape only, PIP sets 
jthe tape density before the zero 
joperation. 

i 

Parity 

1 

|/ZE/PAR:ODD 
|/ZE/PAR:EVEN 

1 

I 

|For magnetic tape only, PIP sets 
j the parity of the tape before the 
j zero operation. 

Privileged-Only Switches 


1 

1 

Lock 

1 

I/LOCK 

1 

1 

1 

|The system locks PIP in memory for 
|the duration of the current 
joperation. Note that you cannot 
jabbreviate /LOCK. 

I 

Priority 

|/PRIOR 

1 

1 

1 

|The system runs PIP at special 
Ipriority for the duration of the 
jcurrent operation. Note that you 
jcannot abbreviate /PRIOR. 


+ 

I 

+ 

I 

+ 


+ 

! 

+ 


+ 

I 

+ 
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File Transfer Operations 

File transfer operations have the following command format: 


output/sw= 

= input/sw 


where: 


output 

specifies a single file specification. 

input 

specifies from one to six file specifications. If you 
specify one file specification, PIP copies that file 
to the output file. If you specify more than one file 
specification, PIP concatenates copies of the input 
files and writes them to the output file. PIP does 
not alter input files. 

/sw 

specifies one or more switches that determine how PIP 
modifies the file transfer. If you do not specify a 
switch when performing disk-to-disk transfers, PIP 
performs a block mode (/BL) transfer by default. In 
a /BL transfer, PIP copies the input file data, 
block-by-block, and any input file attributes into 
the output file. PIP continues the transfer until the 
last of the input file data has been copied. 

If you do not specify a switch on disk to nondisk file 
transfers, PIP performs a file transfer with format 
translation by default; see the section "File Operations 
Involving Attributes." When transferring RMS files 
with attributes to non-disk - structured devices, PIP 
translates the file to ASCII stream or formatted binary, 
depending on the file attributes. However, if the file 
contains fixed length records of 512 bytes, for example 
a task image or library file, PIP does not translate the 
file but performs a /BL transfer. Do not use PIP to 
transfer a bootable magnetic tape between tapes of 
different densities. The bootstrap block on the tape 
works at only one density. 


Because PIP can write magnetic tapes that conform to a subset of the 
American National Standard Institute (ANSI) standard X3.27-1978 - 
magnetic tape and file structure for information interchange, file 
transfer operations with tape can preserve file attribute and data 
format information. 

Use the following procedures to make sure PIP transfers information 
correctly. 
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RSTS/E Disk to RSTS/E Tape transfer: 

1. Mount the output magnetic tape and use the ASSIGN command to 
specify ANSI label format. For example: 

ASSIGN MTO:.ANSI 

2. Use PIP to initialize the tape, write a volume ID, and set 
density and parity, if desired; see the section "Initializing 
Directories". For example: 

PIP MTO:TAPIT/ZERO/DEN:8 0 0/PAR:ODD 

In the example command line, MTO: specifies the device, TAPIT 
specifies the volume ID, and the DEN and PAR switches specify 
a density of 800 bpi and odd parity. If you omit the volume 
ID when initializing.an ANSI magnetic tape, PIP displays the 
following error message: 

?Illegal file name -- file mmx:. 

3. Use the /BL switch; see the section "Block Switch", to copy 
the files to a tape. For example: 

PIP MTO:FORMS.DAT=FORMS.DAT/BL 

PIP creates the output file in U (undefined) format and 
retains all attribute information in the file header label. 
Use this type of transfer only between RSTS/E systems. Only 
PIP recognizes U format; it is not defined by ANSI standard 
X3.27-1978. 

RSTS/E Disk to non-RSTS/E Tape transfer: 

1. Mount, ASSIGN, and initialize the output tape as described in 
the previous steps 1 and 2. 

2. To transfer a file without attributes that contains stream 
ASCII data to ANSI D record format, use the PIP /RMS:FA 
switch and option; see the section "File Operations Involving 
Attributes." For example: 

PIP MMO:REPORT.DAT/RMS:FA=REPORT.DAT 

To transfer FCS (RSX File Control Services) or RMS files with 
attributes, you do not have to specify any switch. However, 
you can copy only RMS sequential files. Therefore, to 
transfer RMS relative and indexed files to ANSI labeled tape, 
you must first use the RMS conversion utility (RMSCNV) to 
convert them to sequential organization. PIP translates 
sequential files with attributes to their appropriate ANSI 
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record format; see the section "File Operations Involving 
Attributes." 

Tape to disk transfer: 

1. Mount the input tape and use the ASSIGN command to specify 
ANSI label format. For example: 

MOUNT MTO:TAPIT/ANSI/NOVERIFY/DEN:800/PARITY:ODD 

TAPIT is the ANSI volume ID for the tape. 

2. Use PIP to copy the tape file to disk. For example: 

PIP FORM.DAT=MT0:FORM.DAT 

PIP reconstructs the file attributes from tape and restores 
the file to its former format. 

If the file you are transferring to disk was originally 
transferred to tape with the PIP /RMS:FA switch and option 
(to convert from stream ASCII to ANSI D format), the output 
disk file is an RMS variable length record file with implied 
carriage return. 

You can use the /CL switch to copy files with the correct 
cluster size; see the section "Cluster Size Switch." Use 
RMSCNV to convert files (originally converted from RMS 
relative or indexed files to sequential files) back to their 
original format. If the file resides within one volume (tape 
reel), you can use either RMSCNV to convert to relative 
organization format or RMSIFL to load an indexed file 
directly from tape. See the RSTS/E RMS-11 User's Guide for 
information about these RMS utility programs. 

3. Dismount the tape to release the assignment made in step 1. 

In addition, you can include the /UNLOAD switch. For 
example: 

DISMOUNT MTO:/UNLOAD 

This manual does not discuss RSTS/E disk-to-RSTS/E disk transfers 
because there is no advantage to simply copying files from one disk to 
another within the same account in the public structure. The RSTS/E 
system stores files on the public structure so you can access them 
efficiently. Copying within the public structure does not improve 
this efficiency and can cause problems if you use wildcards. An 
exception condition such as an I/O error or CTRL/C may cause PIP to 
delete both the old and the new copies of the file you are 
transferring. 
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If you find that it is necessary to transfer files between public 
disks in the same account, there are three safe ways to transfer the 
files: 

o Mount either the source or the destination disk as a private 
disk. This prevents RSTS/E from deleting the source file 
when the destination file is opened. After you confirm that 
the operation is successful, delete the source files, 
dismount the private disk and remount it as a public disk. 

o Assign a temporary name to each file you want to transfer, 
and then delete the old files after a successful transfer 
operation. For instance, to move all *.ODL files from DBl: 
to DBO:, you can use the following commands: 

PIP DBl:*.XDL=DB1:*.ODL/RE [Rename all the .ODL files on DBl:1 
PIP DBO:*.ODL=DBl:*.XDL [Transfer the files to DBO:] 

PIP DB1:*.XDL/DE [Delete the files from DBl:] 

o Use two transfers; go first to tape, or to a private disk, or 
to another account. 

If you specify a non - file - structured device in the input file 
specification, PIP ignores the file name and type even if you use 
wildcards. 

If you transfer data to the line printer and the printer goes 
°ff*line, PIP displays the following message: 

Line printer hung - put online to continue or type CTRL/C 

Following the message, PIP rings the terminal bell every ten seconds 
until you put the printer on line or enter CTRL/C. If you enter 
CTRL/C, PIP returns to the * prompt. 


Wildcard Usage in File Transfer Operations 

Input and output file specifications can contain wildcard characters; 
see the section "Wildcard Specifications." For example: 

DL1:*.*/CL:4=[2,2]*.MAC 

PIP copies all files with a .MAC type in account [2,2] on the public 
structure to your account on RL01 unit 1. PIP preserves protection 
codes and creates all output files with a cluster size of 4 (see the 
section "Cluster Size Switch"). Because PIP substitutes wildcards for 
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missing elements of the command line, the following command is 
equivalent to the previous one: 

DLl:/CL:4=[2,2].MAC 

The * wildcards are legal for output file accounts and for input file 
accounts if the input file resides on disk or magnetic tape. 

You can also use the ? wildcard in input or output file 
specifications. If a corresponding character exists in the input file 
specification, PIP supplies it for the ? character in output file 
specifications. For example, suppose files MYFIL1.TXT and MYFIL2.TXT 
reside in your account on the public disk structure and you use the 
following command: 

HS????.TXT-MYFILl.TXT, MYFIL2.TXT 

PIP creates files HSFIL1.TXT and HSFIL2.TXT consisting of files 
MYFILl.TXT and MYFIL2.TXT, respectively. 

Suppose files Ml.TXT and M2.TXT reside in your account on the public 
disk structure and you use the following command: 

HS? ? ? ?.TXT-M1.TXT,M2.TXT 

PIP performs two copy operations. First PIP copies file Ml.TXT to 
HS.TXT, and then it copies file M2.TXT to HS.TXT. The final result is 
one file named HS.TXT consisting of the contents of file M2.TXT. 

If the output specification is such that PIP tries to create a file 
name with embedded spaces, PIP displays the error message "?Illegal 
output filename" ignores the request, and proceeds to the next input 
file, if any. For example: 

????M?.TXT=Ml.TXT,M2.TXT 

PIP displays two error messages. First, PIP tries to create a file 
named Ml M .TXT. Because this file name contains embedded spaces, PIP 
displays the error message "?Illegal output filename". PIP then 
proceeds to the next input file, attempting to create a file named M2 
M .TXT. Again, PIP displays the error message "?Illegal output 
filename". 


The Help Switch 

The /HE switch directs PIP to display information about input and 
output file specifications, switches, and options on your terminal. 


2-116 




System Utilities 
PIP 


The Access Switch 

The /AC switch applies only to disk resident input files. When you 
specify this switch, PIP changes the input file's date of last access 
to the current date before copying the file to the output file. If 
you do not specify this switch, PIP does not change the file's date of 
last access and preserves it during the transfer. Even if the input 
disk is initialized for an access update on date of last write, the 
/AC switch causes PIP to change the access date. 


The Append and Extend Switches 

The /AP and /EX switches are synonymous. When you specify either of 
these switches at the end of an input file list, PIP transfers the 
data from the input files (which can be on tape or disk) and appends 
the data to the end of the output file (which must be on disk). This 
has the effect of extending the output file. For example: 

A.DAT=B.DAT,C.DAT/AP 

In this example, A.DAT contains its original data followed by the data 
transferred from B.DAT and C.DAT. DIGITAL does not recommend using 
these switches if the output file has attributes and was created under 
control of the RSX File Control Services or RMS, because PIP does not 
update the end-of-file attribute. 

If the specified output file does not exist, PIP returns the error 
message ?Can't find file or account, and creates the file. You cannot 
append a file to itself. If you try, PIP returns the error message 
?Protection violation. 


The ASCII Switch 

The /AS switch applies to output files that you want to contain 
formatted ASCII data. When you specify this switch, PIP transfers the 
data from the input file, discards null and RUBOUT characters, and 
copies the data to the output file. This switch can be useful 
following an append transfer (see the previous section). The /AP 
switch causes PIP to append input data to the last free block of the 
output file. If the last block contains null characters, these 
characters remain in the file following the transfer. You can use the 
/AS switch in a subsequent transfer to delete the null characters. 

Do not use the /AS switch to transfer files that contain 8-bit binary 
data. The binary data uses the parity bit, which PIP discards. The 
bytes in a virtual array or block I/O file can take any pattern of 
eight bits, one of which can be CTRL/Z. Because PIP terminates the 
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transfer when it finds CTRL/Z, some data can be lost. To transfer 
such a file, use the /BL (Block) switch (see the next section). 


The Block Switch 

The /BL switch directs PIP to perform a block-by-block image copy of 
the input file to the output file. PIP performs no translation on the 
data and preserves all file attributes. Block transfer is the default 
file transfer operation. 

If you are transferring an RMS sequential file to a nondisk device and 
want to preserve the RMS format, specify the /BL switch. (You can 
also use the /RMS switch; see the section "File Operations Involving 
Attributes." If you do not include either the /RMS or /BL switch in 
the command line, PIP automatically converts the RMS format to 
formatted ASCII or formatted binary. Also use the /BL switch to 
correctly transfer RMS relative and indexed files between RSTS/E 
systems. 

If you specify the /BL switch on a transfer to an ANSI labeled 
magnetic tape, PIP writes U format records and performs the block mode 
transfer. 

If you specify a single contiguous input disk file, the /BL switch, 
and a single output disk file, PIP attempts to create a contiguous 
disk file. If PIP fails to create the output file contiguously, it 
creates it noncontiguously and displays the warning message % File 
created noncontiguous. 

When PIP performs a block mode transfer (either by default or because 
you include the /BL switch) from a nondisk device to a disk, it 
examines the output file type. If the the file type indicates an 
executable image (.BAC, .TSK, .SAV, and so on.), PIP creates an 
executable file (sets the executable bit) and names the file as 
executable under its appropriate run-time system. 

Note 

PIP determines if a file is compiled by comparing it 
to a list of default executable file types. PIP 
creates this list from the list of installed run-time 
systems that are current when you invoke PIP. If PIP 
detects conflicting file types (for example RSX uses 
•TSK) PIP assigns the name of the first run-time 
system on its list whose file type matches the output 
file type (see the section "Run-Time System Name 
Switch"). 
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A block mode transfer is actually an image mode transfer. Thus, a /BL 
specification allows transfers between DECtape (510-byte block) and 
disk or magnetic tape (512-byte block). When such a transfer takes 
place, PIP transfers each DECtape block to a disk block and fills the 
excess bytes in the last block with null characters. For a disk to 
DECtape transfer, PIP places the two extra bytes in a new block. PIP 
does not pad excess bytes with nulls until it reaches the last output 
block. 


The Block Size Switch 

The /BSIZE switch specifies a block size for output to magnetic tape. 
If you do not use this switch, PIP transfers data to an output 
magnetic tape using a default block size of 512 bytes. You can use 
the /BSIZEin switch, where n is an even integer in the range of 18 to 
4096 bytes, to create a magnetic tape file whose block size is larger 
or smaller than the 512-byte default. If you specify an illegal value 
for n, PIP displays the error message ?Bad block size. 

Use of the /BSIZE switch has the following restrictions: 

o Use the switch for magnetic tape only; PIP ignores its use on 
disks. 

o The switch applies only to output on magnetic tape; PIP 
automatically handles input magnetic tape with block sizes 
other than 512 bytes. 

o If the output tape is in ANSI format and is intended for 
interchange on another operating system, the block size 
specification must be an even integer between 18 and 2048 
bytes. 

o If the output tape is intended for use on the RT-11 operating 
system, the block size must be 512 bytes. 

o Using the /BSIZE switch can increase the amount of buffer 
space PIP uses. Thus, when reading or writing block sizes 
larger than 512, invoke PIP with the CCL /SIZE:n switch or, 
if under the RT11 Run-Time System, with the SIZE n immediate 
mode command. 


2-119 



System Utilities 
PIP 


The Cluster Size Switch 

The /CL:n switch specifies the cluster size in an output disk file 
specification. The cluster size you specify in n becomes the cluster 
size of the output file or files that PIP creates. You can specify 
the value of n in two ways: 

o Specify a power of 2 that is greater than or equal to the 
pack cluster size of the disk involved in the transfer, and 
less than or equal to 256. 

o Specify a negative of a power of 2 to specify either a 
cluster size of -n or the pack cluster size of the output 
device, whichever is greater. 

If you use this switch, place it immediately after the output file 
name on the PIP command line, unless you also include the /MO switch. 
In the latter case, place the /MO switch immediately after the output 
file name, followed by the /CL switch (see the section "Mode Switch"). 
If you do not include the /CL switch in the command line, PIP 
preserves the cluster size of the input file during the transfer. PIP 
ignores the switch for nondisk devices. For a complete discussion of 
cluster size, see the RSTS/E Programming Manual. 


The Go or Ignore Switches 

Specify either the /GO or /IG switch if you want PIP to ignore the 
error message ?Data error on device or any magnetic tape record length 
errors. If this error occurs in a record other than a label record, 
and you include one of these switches, PIP ignores the error and 
continues the operation. With these switches, you can use PIP to 
partially salvage files from damaged or compromised media. However, 
PIP cannot retrieve files whose label records are unreadable. 


The Mode Switch 

RSTS/E allows you to specify modes in OPEN statements that set special 
characteristics for devices. You can use the /MO:n switch in the PIP 
command line to specify the mode PIP uses to open the files. When you 
include this switch, place it immediately after the output file name. 
See the RSTS/E Programming Manual for information about mode values 
and how to use them. 
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The /NE switch, specified for disk output files, directs PIP to create 
a new file and use the current date for both the creation date and 
last access date. The /RET switch, also specified for disk output 
files, directs PIP to retain the creation date and last access date of 
the input file. The /RET switch is the default, unless your system 
manager has installed the optional feature patch that makes the /NE 
switch the default. 


The No Attributes Switch 

The /NOA switch disables the transfer of disk file attributes during 
PIP copy procedures. If the input file contains attribute information 
that you do not want to copy to the output file, include the /NOA 
switch. If you do not include this switch, PIP automatically 
transfers attributes. 


The No Supersede Switch 

For an output file, the /NOS switch prevents PIP from making a file 
transfer if the specified output file already exists. This switch 
allows you to protect the output file from deletion and overwriting. 
The action of this switch is independent of the file protection code, 
which can also prohibit write access. 

When you specify /NOS and the output file does not exist, PIP creates 
the file and transfers the data. PIP does not display an error 
message. 

When you specify /NOS and the output file does exist, PIP displays the 
error message ?Name or account already exists and cancels the data 
transfer. 

If you specify the NOWARN option (/NOS:NOWARN) and the output file 
exists, PIP cancels the data transfer but does not display an error 
message. 

If you use the QUERY or INSPECT option (/NOS:Q or /NOS:IN), PIP 
displays the message "OK to replace existing file?" if the output file 
already exists. Type Y, YE, or YES to replace the file. Type N, NO, 
or press RETURN to cancel the data transfer. 
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The Run-Time System Name Switch 

For a file structured disk transfer, use the /RTS switch to change the 
run-time system name of the output file. If there is no output file 
specification, PIP changes the name of the input file's run-time 
system to the name you specify in the switch. 

If you do not include the /RTS switch, PIP transfers a run-time system 
name to the output file based on the following criteria: 

o If the input file resides on a file - structured disk, PIP 

transfers the input file's run-time system name to the output 
f ile. 

o If the input file does not reside on a file - structured disk, 
PIP searches for a run-time system whose executable file type 
matches the output file type. PIP assigns a name to the 
output file based on the first such run-time system it finds. 
PIP also assigns an executable protection code to the output 
file. 

o If neither the first nor second case applies, PIP assigns the 
run-time system name under which it is running to the output 
file. 


The Update Switch 

Use the /UP switch for output disk files. It directs PIP to attempt 
an update in existing files of the same name before it creates a new 
file. When you include the /UP switch, PIP searches the output device 
for files that match the output file specification. If it finds a 
matching file, PIP opens the file and replaces the file's data with 
that of the corresponding input file. If PIP cannot locate a matching 
output file, it creates a new file. 

If PIP finds a matching output file that is larger than the 
corresponding input file, PIP writes the input file data to the output 
file without disturbing the output file excess data. For example, a 
34-block input file changes only the first 34 blocks of a 48-block 
output file. If you also specify the /LO or /WA switch (see the 
section "File Operation Switches"), PIP reports that the input file 
was "Copied into prefix of" the output file. 

If PIP finds a matching output file that is shorter than the 
corresponding input file, PIP extends the output file. For example, 
if the input file is 48 blocks and the output file is 34 blocks, PIP 
extends the output file to 48 blocks and replaces the output file data 
with the input file data. 
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A RSTS/E disk file may or may not have attributes, depending on the 
type of file. For example, all RMS files have attributes, while 
BASIC-PLUS files do not have attributes. 


In addition, RMS files and non-RMS files have different formats. RMS 
files can have a fixed length or variable length record format and one 
of several carriage control formats (implied, embedded, FORTRAN, or 
print format). Non-RMS files can have stream (formatted ASCII) 
records, binary record format, BASIC-PLUS block I/O, or virtual array 
format files. 


Similarly, DOS labeled magnetic tape differs from ANSI labeled tape in 
file attributes and format. DOS labeled tapes have no attributes and 
can contain formatted ASCII or formatted binary files. ANSI labeled 
tapes have limited file attribute information that is similar to RMS 
sequential files. 


You can direct PIP to use the /RMS switch and its options to translate 
from one format to another as it transfers input disk file data to 
output disk files. 


Use the /RMS switch only on input or output files that are resident on 
disk devices, or on ANSI or DOS labeled magnetic tape. The switch 
forces PIP to translate the file data format when transferring the 
file. You cannot use this switch for both input and output files in 
the same command line. 


If you include the switch in the command line for input disk files, 
PIP translates RMS format to formatted ASCII or formatted binary. If 
you include the switch in the command line for output disk files, PIP 
translates formatted ASCII or formatted binary to RMS format. 


When you specify the /RMS switch, PIP determines whether or not to 
translate between RMS format and formatted ASCII or formatted binary. 
However, PIP allows you to include one of five options with the switch 
to specify a particular translation. The available options are: 


Option 
: FA 


: FB 


: FTN 



Meaning 

For input disk files, translate from formatted ASCII. For 
output disk files, translate to formatted ASCII. 

For input disk files, translate from formatted binary. 

For output disk files, translate to formatted binary. 

For input disk files, translate RMS FORTRAN carriage 
control to formatted ASCII. 
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Option 


Meaning 


: IM 


For input disk files, translate from RMS format to 
formatted ASCII or formatted binary (same as /RMS with no 
option), but also remove record lengths from variable 
length records and padding bytes. 


: PRN 


For input disk files, translate RMS print file format to 
formatted ASCII. 


To translate a Task Builder .MAP file to formatted ASCII, you must use 
the /RMS:FA switch. 

Use of the /RMS switch options to transfer files with attributes has 
the following restrictions: 

o PIP cannot concatenate two or more RMS data files. An 

attempt to do so results in a file with invalid attributes. 
All the data in the file is not accessible. To concatenate 
RMS files, use the RMS utility RMSCNV (see the RSTS/E RMS-11 
User's Guide). 

o If a file contains variable length records or fixed length 
records with RMS FORTRAN carriage control, PIP can only 
translate the file to stream (formatted ASCII) records. 

o If a file is an object module, PIP can only translate the 
file to formatted binary. 

o If you do not specify the /RMS switch on a transfer of disk 
files to DOS labeled magnetic tape, the following default 
transfers occur: 

If the input RMS file contains implied or RMS FORTRAN 
carriage control, or if it is a print format file, PIP 
creates an output file in stream (formatted ASCII) 
format. 

In all other cases, PIP creates a formatted binary file. 


o If you do not specify the /RMS switch on a transfer of disk 
files to ANSI labeled magnetic tape, the following default 
transfers occur: 

If the input RMS file contains fixed length records, PIP 
creates an output magnetic tape file in ANSI F record 
format (fixed length format). 
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If the input RMS file contains variable length records, 
PIP creates an output magnetic tape in ANSI D record 
format (variable length format). 

If the input file contains no attributes, PIP creates an 
output magnetic tape file in U (undefined) record format. 
Note that you may not be able to transfer tapes with U 
format to non-RSTS/E systems. 


o If you do not specify the /RMS switch on an ANSI magnetic 

tape to disk transfer, the following default transfers occur: 

If the input magnetic tape file is in ANSI F record 
format, PIP creates an output disk file with RMS fixed 
length records. 

If the input magnetic tape file is in ANSI D record 
format, PIP creates an output disk file with RMS variable 
length records. 

If the input magnetic tape contains ANSI labels and is 
not in F or D record format or the tape format does not 
contain a header label 2 (HDR2), PIP performs a block 
mode transfer (see the section "Block Switch"). 


Date Related Switches 

Use the date switches to specify the inclusion or exclusion of certain 
files in a PIP transfer based on the creation date or date of last 
access. These switches are especially useful for modifying wildcard 
file specifications. 

By default, PIP transfers files based on the creation date. However, 
the system manager can install an optional feature patch that allows 
PIP to use the date of last access as the default. 

You can specify the date of last access (/DLA) or the creation date 
(/CRE) switch in the command line to override the installed default. 
The /DLA switch directs PIP to use the date of last access; the /CRE 
switch the date of creation. The switch you use determines whether 
the /TO, /ON, /AF, /BE, /SIN, and /UN switches use the creation date 
or the date of last access. These switches do not require an 
argument. 
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The today switch (/TO) directs PIP to operate only on those files with 
a date that matches the current date. This switch does not require an 
argument. 

The /ON:date switch directs PIP to operate on those files with a date 
that matches the switch date. This switch requires a single argument 
that specifies a date in the format: 

/ON:dd-mmm-yy 

where: 

dd specifies the day of the month. 

mm specifies the first three letters of the month. 

yy specifies the last two digits of the year. The default is the 

current year. 


For example: 

/ON:13-Jun-85 

When used in combination, the After (/AF)> Before (/BE), Since (/SIN), 
and Until (/UN) switches, allow you to specify a range of dates. Only 
one switch is necessary in the PIP command line; however, you can use 
two switches to specify an upper boundary and a lower boundary. When 
you specify a range, PIP processes only those files whose date falls 
within the range and ignores those files whose date is outside the 
range. Because of a conflict between the /SIZE and /SINCE switches, 
the minimum abbreviation for the /SINCE switch is /SIN. 


To specify a date with these switches, use the same format as the /ON 
switch. 


The following examples show the use of these switches: 


Switches 

/SIN: 09-APR-85 
/UN: 01 - MAY- 8 5 

/AF:15-JAN-85 
/UN:01-MAY-85 

/SIN:13-JUN-85 
/BE:20-JUN-85 

/AF:15-DEC - 85 
/BE:09-APR-85 


Lower Boundary 
09-APR-85 

16-JAN-85 

13 -JUN- 8 5 

16 - DEC-85 


Upper Boundary 
01-MAY- 8 5 

01-MAY- 8 5 

20-JUN-85 

08-APR-85 


2-126 



System Utilitie 
PI 


The File Operation Switches 

You can apply the following file operation switches to the four major 
operations that PIP performs: copy, delete, rename, and directory 
listing. Use these switches to improve the performance of PIP 
operations and as auxiliaries to those operations. 

You can specify the /HA switch when PIP conducts wildcard searches on 
magnetic tape devices. When you include this switch, PIP stops 
processing when it finds a file on magnetic tape that does not match 
the wildcard specification. Without this switch, PIP continues its 
search until it reaches the end of the tape. 

Inspect or Query Switch (/INroption or /QU:option) -- You can use the 
/IN switch when the PIP operation involves wildcard specifications. 
You can include the switch at any point in the command line. When 
present, it directs PIP to display the file name of each file that 
matches the wildcard specification. PIP displays the file names one 
at a time and allows you to respond with one of the following: 


Response 


Meaning 


Y (for Yes) 


Any other 
response 


Directs PIP to execute the operation on this file and 
search for the next matching file. 

Directs PIP to skip this file and search for the next 
matching file. 


CTRL/Z 


Directs PIP to terminate processing of the current 
wildcard specification without processing this file. 


When you include the /IN switch, it applies to every input file 
wildcard specification. 

The /IN switch accepts an option (/IN:S) that directs PIP to print the 
file name, file type, file size, protection code, creation date, and 
date of last access of each file that matches the wildcard 
specifications. 

The /LO or /WA switches are'synonymous. You can include them anywhere 
in the command line. When you specify /LO or /WA, PIP displays a 
report of all actions taken during execution. Note that the system 
manager can install an optional feature patch that causes PIP to log 
all actions by default. 

Use the /NOL switch to suppress the display of the execution report 
where logging is enabled as the system default. 
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When PIP begins its search for an input file on magnetic tape, it 
first rewinds the tape. You can specify the /NO or /RW:NO switch 
anywhere in the command line to direct PIP to suppress the automatic 
tape rewind. When you specify one of these switches, PIP begins its 
file search at the current tape position. 

You can specify the /VE or /ID switch anywhere in the command line to 
direct PIP to print information about the version and current 
configuration on the terminal. 


The File Deletion Switches 

When you specify the /DE switch in a command line input file 
specification, PIP deletes all files that match the specification. 

You can apply the switch only to a disk or DECtape input file 
specification. If you do not specify a file name or a type, PIP 
prints the following error message: 

?Filename and type must be specified 

You can use wildcard characters in file deletion operation's. If you 
do specify wildcards, you can also include the /IN switch (see the 
previous section) in the command line to prompt for confirmation of 
all file deletions. 

The /DE switch applies to all input file specifications on the command 
line in which it appears. Therefore, do not attempt to specify any 
other PIP operation in a command line that contains the /DE switch. 

You can modify the /DE switch with the /NO option (/DE:NO). When you 
include this option, PIP does not display an error message if the file 
you want to delete does not exist. 

If the file you want to delete has the privileged (128) bit set in its 
protection code, PIP writes zeros in the file, renames it to a 
nonprivileged code, and deletes it. When PIP deletes a file with the 
privileged bit from the system by means of the UNSAVE command or KILL 
statement, the File Processor performs the same actions as the PIP 
delete operation. If you want such a delete operation, use PIP 
because it is faster than the File Processor, which is subject to 
greater system demand. 

You can specify the /ER, /WO, or /WIPE switch with the /DE switch. 

When you include one of these switches, PIP writes zeros in the file 
before deleting the file. As with the /DE switch, these switches 
apply to every input file specification on the command line. 
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The File Rename Switch 

When you apply the /RE switch to a disk or DECtape input file 
specification, PIP changes the input file name to that of the output 
file specification. During the /RE operation, PIP does not transfer 
any data. 

Use the following format when renaming files with the /RE switch: 

newname.type/PROT:n=oldname.type/RE 

PIP renames file oldname.type to newname.type and changes its 
protection code according to the value you assign to n. The data in 
file newname remains unchanged. 

You can use wildcard specifications with the /RE switch to perform 
multiple file renames. PIP requires that you specify only those 
elements of the output file specification that you want to change. If 
you do not include an input file specification, PIP renames all files 
in the current account on the public structure. 

The following example shows the use of the /RE switch: 

PIP *.C??«STAT?.B7S/RE 

PIP changes the file type of every file whose file name begins with 
STAT and whose type begins with B and ends with S. In each case, PIP 
changes the first character of the type to C. 

To change only the protection code, include the new protection code on 
the input file specification and omit the output file specification. 
For example: 

oldname.type/PROT:n/RE 

If you attempt to rename a file that does not exist, PIP returns the 
error message ?Can't find file or account, skips that operation, and 
continues processing. If you attempt to rename a file to a name that 
already exists, PIP returns the error message ?Name or account now 
exists, skips that operation, and continues processing. You can use 
the NOWARN option (/RE:NOWARN) to suppress the display of the ?Name or 
account now exists error message. 


The Directory Listing Switches 

PIP provides five switches and several options that allow you to 
display a directory listing. This listing is similar to the one you 
can obtain using the DIRECT system program (see the DIRECT utility, 
section "DIRECT Switches.)" 
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The /DI and /LI switches direct PIP to display a full directory 
listing and allow you to modify the listing. Table 2-17 lists the 
a/ailable options. Specify options in the following format: 

/DI:option 

or 

/LI:option 

The /BR and /F switches do not accept an option specification. When 
you include these switches, PIP displays an abbreviated directory 
listing that includes only the file names and types. The /S switch 
directs PIP to display a full directory listing.that is similar to the 
slow listing obtained with the DIRECT system program; (see the section 
"DIRECT Switches"). 

The /DI, /LI, /S, /F, and /BR switches allow PIP to display the 
directory listing of any file - structured device. When you include one 
of these switches in a file specification, which can contain 
wildcards, PIP displays only those files that match that 
specification. PIP displays the listing on your terminal by default; 
however, you can output the listing to another device or file by 
including an output specification. 

Table 2-17 lists the options that you can specify with the /DI or /LI 
switches. 

Table 2-17: PIP Directory Listing Options 


Option 

1 

Format 

| Meaning 


1 


1 

Allocated 

1 

1 

:AL 

1 

| List file name, type, and the number 
j of blocks allocated to the file. 

Cluster size 

1 

1 

1 

: CL 

j List file name, type, and file 
j cluster size. 

Date 

1 

1 

1 

: DA 

1 

| List file name, type, and file 

j creation date. 

1 

Directory 

1 

1 

1 

1 

: DI 

| List file name, type, size, 
j protection code, creation date, and 

j column headers. 

1 

Extended 

1 

1 

1 

1 

: EX 

| List file name and type same as :TY 
j (provided for compatibility with 
j previous versions of RSTS/E). 
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Table 2-17: PIP Directory Listing Options (Cont.) 


+ 






1 

Option 

1 

Format 

| Meaning 

1 

T 

1 


1 


| 

1 

1 

1 

Full 

1 

1 

: FU 

1 

| List heading, file name, type, size. 

1 

1 

1 


1 


| protection code, date of last 

1 

1 


1 


| access, date of creation, time of 

1 

1 


1 


| creation, cluster size, associated 

1 

1 


1 


j run-time system, file position, open 

1 

1 


1 


j status, and summary. 

1 

1 

| 

1 

1 

Header 

1 

1 

: HD 

| Include column headers in the 

1 

1 

1 

1 


1 

1 


j listing. 

i 

1 

1 

1 

1 

Last 

1 

: LA 

l 

| List file name, type, and date of 

1 

1 

1 


1 


j last access or date of last write 

1 

1 

1 


1 

1 


j (depending on disk initialization). 

i 

1 

1 

1 

1 

1 

Name 

1 

1 

1 

:NA 

| List file name. 

I 

I 

1 

I 

1 

1 

Octal attribute 

1 

1 

: OA 

| List file name, type, and octal 

1 

1 

1 


1 


j representation of file attributes. 

1 

1 

| 

1 

1 

Protection 

1 

1 

: PR 

| List file name, type, and protection 

I 

1 

1 

1 


1 


j code. 

1 

1 

1 

Run-time 

1 

1 

: RT 

| List file name, type, and associated 

1 

1 

1 

1 


1 

1 


j run-time system. 

1 

1 

1 

1 

1 

Slow 

1 

1 

1 

:S 

1 

| List all information. 

i 

1 

1 

I 

1 

1 

Symbolic attribute 

1 

1 

:SA or 

| List file name, type, symbolic file 

1 

1 

1 

Attribute 

1 

: AT 

j attributes (see the "File 

1 

1 


1 


j Attributes" section in the DIRECT 

1 

1 


1 


j utility)and caching status. Caching 

1 

1 


1 


j is indicated by one of the following 

1 

1 


1 


j entries: 

1 

1 


1 


| o CACHE:ON:RAN; file will be 

1 

1 


1 


j automatically cached randomly 

1 

1 


1 


j when open. 

1 

1 


1 


o CACHE:ON:SEQ; file will be 

1 

1 


1 


j automatically cached 

1 

1 


1 


| sequentially when open. 

1 

1 


1 


j o CACHE:OFF:SEQ; file will not be 

1 

1 


1 


j automatically cached, but if 

1 

1 


1 


j cached, it will be cached 

1 

1 


1 


sequentially. 

1 
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Table 2-17: PIP Directory Listing Options (Cont.) 


Option 

| Format 

| Meaning 


Size 

1 

| :SI or 

| : SZ 

1 

1 

| List file name, type, and file 

1 

1 

size. 

Summary 

1 

| :SU 

1 

1 

1 

| 

i 

| List only summary data to include 
| number of designated files and total 
| number of blocks occupied by 
j designated files 

i 

Time 

| :TI 

1 

1 

| List file name, type, and date 
| time of creation. 

and 

Type 

| : TY 

1 

| List file name and type. 

i 


Wide 

l 

| :W 

1 

i 

1 

| List file name and type across 
| width of the page or screen. 

i 

the 

Wide 

| :WI 

1 

l 

| List file name only across the 
| of the page or screen. 

width 


The :OA, :SA, :AT, and :S options cause PIP to display file attributes 
in octal or symbolic representation. See the DIRECT utility, section 
'"File Attributes," for a description of the format and meaning of 
these attribute representations. 


The Initializing Directories Switch 

You can include the /ZE switch in the PIP command line to direct PIP 
to initialize (zero) a device or account directory. When you specify 
this switch, PIP deletes all of the files stored in a specified 
account on disk or, if you specify a magnetic tape or DECtape, 
initializes the volume mounted on the specified drive. 

To use the /ZE switch, specify a command line of the following format: 

A 

dev:(proj,progJ/ZE 
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where: 


dev: 


specifies a device. You can specify only one 
device. The default is the public disk structure. 
To initialize an ANSI-labeled magnetic tape, 
specify a device and a file name that represents 
the volume label. 


t proj,prog] 


specifies a ppn. The default is the current account, 
is the initializing switch. 


/ZE 


When PIP detects the /ZE switch in its command line, it prints the 
following prompt: 

REALLY ZERO dev:[proj,prog] ? 

Type Y in response to the prompt to confirm that you want PIP to 
initialize the device or account. Any other response aborts the 
operation and returns you to the PIP command response level. 

You can also use the /ZE switch to specify a change in the density or 
parity of a magnetic tape prior to initialization. System-wide 
defaults for magnetic tape density, parity, and label are set by the 
system manager during system initialization. If you want the system 
to accept a tape with nondefault characteristics, you should ASSIGN 
the tape prior to setting those characteristics (with MOUNT or PIP). 
When the tape is DEASSIGNed, the system reverts to the default 
characteristics set during system initialization. The specifications 
for density and parity are as follows: 

/ZE/DEN:n 

/ZE/PAR:parity 

The /ZE/DEN:n switch combination directs PIP to set the density of the 
tape to the value specified by n before it initializes the tape. You 
can specify these densities: 

800 bpi for 9-track tape. 

1600, bpi for 9-track tape. 

The /ZE/PAR.-parity switch combination directs PIP to set the parity of 
the tape to the type specified before it initializes the tape. You 
can specify these parities: 

/ZE/PAR:ODD For odd parity. 

/ZE/PAR:EVEN For even parity. 
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A 1600 bpi tape can only support odd parity. Also, unless you process 
the tape on a system that requires even parity, DIGITAL recommends 
that you specify odd parity for all output tapes. 

DIGITAL recommends that you use an initialize operation, which 
contains a volume label specification, for all new tapes. 


The /LOCK and /PRIOR Switches 

To use the /LOCK and /PRIOR switches, you must have the TUNE 
privilege. 

When you specify the /LOCK switch in the command line, the system 
locks PIP into memory for the duration of the current operation. 

When you specify /PRIOR in the command line, the system runs PIP at a 
special priority for the duration of the current operation. Normally 
PIP runs at the current user's default priority. When you include 
/PRIOR, the system boosts the priority of PIP by four. 


Multivolume ANSI Magnetic Tape File Transfer 

You can use PIP to transfer files from any input device to one or more 
ANSI labeled magnetic tapes to create a volume set. You can also 
begin a file on one volume of the set and end the file on another, 
assign identification labels to the volumes of the set, and transfer 
the contents of the volume set to any output device. You cannot use 
PIP to transfer multivolume magnetic tapes in DOS format. DOS does 
not permit multivolume transfers because it does not allow file 
segmentation across tape volumes. 

To perform a multivolume transfer, you must first initialize the 
output magnetic tapes with the /ZE switch (see the section 
"Initializing Directories Switch"). The first tape of the output set 
may contain data but each succeeding tape must be data free. PIP 
allows you to specify volume identifications for each output tape. 

This enables you to create an identifiable volume set containing the 
transferred data. The system manager can install an optional feature 
patch that causes PIP to require a volume ID specification. 

When you initiate a multivolume transfer, PIP displays a series of 
messages that notifies you of the end of the output tape. PIP then 
prompts you to specify the device name and unit number of the second 
output tape (the second volume). PIP repeats this process for each 
end-of-tape until it has transferred all of the specified input. 

After PIP reaches the end of an output tape volume, it rewinds the 
tape and takes it off line. 
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• To make sure it retrieves files in the correct order, PIP assigns 

section and sequence numbers to the files it transfers. PIP checks 
these numbers when it transfers files from the tape volumes. The 
numbers are internal and are not user specified. 

You can use file transfer switches on multivolume transfers. The 
directory switches return directory listings only on a single volume. 
For a file segmented across volumes, you must list a directory of all 
volumes to show the true state of the file. 

The following example initializes three tapes in preparation for a 
file transfer, and then uses PIP to transfer the contents of a user 
account to three magnetic tape volumes: 


$ RUN $PIP 

* MM2:TAPE3/ZE 

* MMl:TAPE2/ZE 

* MMO:TAPEl/ZE 

* MM0:*.*«[20,25]*.*/BL 

%END OF ANSI MAGTAPE OUTPUT VOLUME HAS 
%BEEN REACHED 

%PLEASE TYPE THE DEVICE NAME AND UNIT 
%NUMBER OF THE DRIVE WHERE THE NEXT 
%VOLUME MAY BE FOUND 




?MMl:TAPE2 


%END OF ANSI MAGTAPE OUTPUT VOLUME HAS 
%BEEN REACHED 

%PLEASE TYPE THE DEVICE NAME AND UNIT 
%NUMBER OF THE DRIVE WHERE THE NEXT 
%VOLUME MAY BE FOUND 


?MM2:TAPE3 


In this example, you specify a block mode transfer of all files in 
account [20,25] on the system disk to the tape mounted on MMO:. When 
PIP reaches the end of the output tape, it prompts for the next 
volume. In response to the prompt, you type the device name and unit 
number (MMl:) and the optional volume ID (TAPE2). PIP checks the 
output volume ID, if specified, and confirms that the tape contains 
ANSI labels and has been initialized. If the ID is valid and the tape 
is properly initialized and free of data, PIP continues with the 
transfer. PIP repeats this process each time it reaches the end of a 
tape, until it has transferred all of the specified files. When the 
transfer is complete, PIP displays the * prompt. 
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The following example uses PIP to transfer the 
volumes to a user account: 


contents of three tape 


$ RUN $PIP 
*[20,25]=MM0:*.*/BL 


%END OF ANSI MAGTAPE INPUT VOLUME HAS 
%BEEN REACHED 


%PLEASE TYPE THE DEVICE NAME AND UNIT 
%NUMBER OF THE DRIVE WHERE THE NEXT 
%VOLUME MAY BE FOUND 

?MMl:TAPE2 


%END OF ANSI MAGTAPE 
%BEEN REACHED 


INPUT VOLUME HAS 


%PLEASE TYPE THE DEVICE NAME AND UNIT 
%NUMBER OF THE DRIVE WHERE THE NEXT 
%VOLUME MAY BE FOUND 


?MM2:TAPE3 


★ 



In this example, you specify a block mode transfer of all files on the 
tape mounted on MMO: to account [20,25] on the system disk. When PIP 
reaches the end of the input tape, it prompts for the next volume. In 
response to the prompt, you type the device name and unit number 
(MMl:) and the optional volume ID (TAPE2). PIP checks the input 
volume ID, if specified, and makes sure that the file is in the 


correct sequence by checking the section and sequence numbers it 
assigned to the files. PIP also checks that the input tape contains 
ANSI labels. If the volume ID is valid, the file is correct, and the 
tape has ANSI labels, PIP continues with the transfer. PIP repeats 
this process each time it reaches the end of a tape until all of the 
files on the input tape volumes are transferred. 


When the transfer is complete, PIP displays the * prompt. 

If you respond to the volume prompt (?) with a CTRL/Z, PIP interrupts 
the transfer and terminates. 
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PIP Error Messages 


PIP can return two types of error messages: 

o RSTS/E system error messages (for example, ?Can't find file 
or account). See the RSTS/E System User's Guide for 
descriptions of the RSTS/E errors and the proper recovery 
actions. 

o PIP program error messages indicate problems within PIP 
itself and the only recovery is to try the operation again 
(the error may be due to a transient condition). If the 
error continues, notify your system manager. 


?WRITE FAILURE 
?CLOSE FAILURE 
?READ FAILURE 
?LOOKUP FAILURE 
?ENTER FAILURE 
?RENAME FAILURE 
7ZER0 FAILURE 


These errors 
is to try the 
condition). 


indicate problems within PIP itself and the only recovery 
operation again (the error may be due to a transient 
If the error continues, notify your system manager. 
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Formatting a Post-Mortem Dump: The PMDUMP Program 

The system library program, PMDUMP, formats the contents of a 
post-mortem dump into readable form and allows you to copy it to a 
file on any RSTS/E device. The post-mortem dump is written in binary 
by the RSX run-time system or an RSX-based run-time system such as 
BASIC - PLUS - 2. A system programmer or software specialist can use the 
information contained in the dump to view the actual state of the 
program at the time it aborted. 

When you run PMDUMP, the program performs the following operations and 
writes the information to a user-specified output file: t 

o Formats the binary dump and produces a human-readable dump of 
the contents of low-core memory 

o Produces an octal dump of the user's task 

When the program completes its operation, it returns control to RSTS/E 
command level. 


Privilege Required 

To run the PMDUMP program, you need the following: 
o Read access to the input file 
o Create/Rename access to the output file 


When to Use PMDUMP 

Post-mortem dumps are used to determine the state of a task at the 
time the task aborted. Post-mortem dumps do not return an online 
snapshot of the state of a job. The following conditions must be true 
for PMDUMP to be successful in formatting the dump: 

o The run-time system that controls your job must be RSX or 
RSX-based. 

o The task to be dumped must have already aborted (terminated 
abnormally). 

o You must specify the request for a post-mortem dump when you 
input the program to the Task Builder; that is, you must use 
the /PM switch as described in the RSTS/E Task Builder 
Reference Manual . 
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Running the PMDUMP Program 
To run PMDUMP, type: 

$ RUN AUXLIB$:PMDUMP 

The program displays a header line followed by a number sign (#) 
prompt, which indicates it is ready to accept command input. 

In response to the prompt, type one of the following: 


Command 

Result 

<RET> or <LF> 

Accepts a complete default. 


outfil.typ=infil.typ Specifies the output and input files used by 


CTRL/2 

PMDUMP. 

Terminates PMDUMP. 


If you do not specify an input file, the program defaults the file 
name to the following: 

PMDnnn.PMD 

In the default file name, nnn refers to the current job number. Note 
that this file name construct is identical to that of the dump file 
created by the RSX Run-Time System. 

If you do not specify an output file, the program defaults the file 
name to that specified or defaulted for input, and the type to .LST. 

The program defaults for all elements of the file specification are as 


follows: 


Device 

SY: 

account 

The current account 

file name 

The input file name 

type 

.LST for output, .PMD for input 
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If you press RETURN in response to the prompt, the program applies the 
following defaults: 

o The program places the files in the current account on the 
public disk structure (SY:) 

o The input file name is PMDnnn.PMD 

o The output file name is PMDnnn.LST 


Contents of the Post-Mortem Dump 

The following description of the PMDUMP listing is keyed to the 
example that follows: 


Description 

The name and account of the task being dumped and the date 
and time that the dump was generated. This information 
appears as a header line on each page of the dump listing. 

The program name, or the name you assigned in the Task 
Builder TASK option, for the task being dumped. Partition 
name is either GEN or the name you specified in the Task 
Builder PAR option. 

The size of the task in octal and decimal words. PMDUMP 
gives the task size at the time it was initially loaded 
and also at the time of the dump. 

The synchronous and asynchronous system traps in effect when 
the task was dumped. 

The task status flags that were set at the time of the dump. 

The entry point of the program, either by line number in 
Parameter Entry or by CCL command. CCL Entry also indicates 
whether a /DETACH or /SIZE switch is specified. Directive 
Status and Impure Area Pointers are used by the RSX emulation 
code. 

The logical unit assignments in effect at the time of the 
dump. This information includes the device name, the status 
flags set for that device, and the allocated buffer space in 
octal and decimal words. 
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8 A breakdown of the task's keyword value. The last two octal 
characters of the value represent those set by the user 
program. The other flags are set by the run-time system and 
by the RSTS/E monitor. 

9 The contents, in octal, of the file request queue block 
(FIRQB) and the transfer request block (XRB). This 
information represents the monitor requests for file and I/O 
operations at the time of the dump. 

10 The contents of the job's core common area when the dump was 
made, in ASCII characters and octal byte values. 

11 The assigned PPN, default protection code, and logical name 
table entries assigned by the user job at the time the dump was 
made. 

12 The program counter (PC) and processor status word at the time 
the task was loaded. This information represents initial 
conditions. 

13 The general registers, stack pointer, and processor status at 
the time of the dump (contrast with Item 12). 

14 The task stack at the time of the dump. 

15 An octal dump of the task. The first 1000 octal bytes 
reflect the status displayed in the previous portion of the 
listing. 

The information shown from octal byte 1000 to the value of the initial 
stack pointer (Item 13) represents the current contents of the stack 
region. In this example, the contents of the used portion of the 
stack are shown in the region from octal byte 1760 to octal byte 1777. 
Octal byte 001760 contains the value 003770, which is the stack 
pointer value shown in Item 14. Note that the PDP-11 stack starts at 
the high address and works toward the lower address. 

The octal bytes following the stack display the task image at the time 
of the dump. This display, which represents the state of the program 
at the time it aborted, is especially useful to software specialists. 
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Post-Mortem Dump Example 

An example of a post-mortem dump is: 


1 Post-Mortem Dump of SY:[1,201]PMD030.PMD on 13-Jun-85 at 09:15 AM 
Formatted Dump of Low Memory 


2 Task Name : FOO 

Partition Name : GEN 


Task Size (without Extension) 
3 Load Size of Task 
Current Task Size 


002040 (1056.) words 
004000 (2048.) words 
004000 (2048.) words 



ODT SST Vector Address : 000000 

ODT SST Vector Length : 000 (0.) 

4 Task SST Vector Address : 000000 

Task SST Vector Length : 000 (0.) 

FPP AST Service Address : 100124 

CTRL/C AST Service Address : 000000 


5 Task Flags : 010000 (4096.) Task Flags Set 

Post-Mortem Dump Requested 
User Parameter on Entry : 000000 
CCL Entry Flags : 000000 

Directive Status Word : 000001 

6 

FCS Impure Area Pointer : 000000 

OTS Impure Area Pointer : 002372 

Auto-Load Impure Area Pointer : 004044 
Extended Impure Area Pointer : 000000 



7 LUN (Logical Unit Number) Table 


LUN #0 : 

Device Name : TI: 


Device 

Flags 

: 000007 

Flags are : 

Record Oriented Device. 
Carriage Control Device 
Terminal Device 

Buffer 

Size 

: 000200 

(128.) 

LUN #1 : 

Device 

Name 

: SY: 


Device 

Flags 

: 000010 

Flags are : 

Directory Device 

Buffer 

Size 

: 001000 

(512.) 
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LUN #2 : 


Device 

Name 

l 

SY: 

Device 

Flags 

• 

000010 

Buffer 

Size 

• 

• 

001000 

LUN #3 

• 

• 



Device 

Name 

• 

• 

SY: 

Device 

Flags 

• 

• 

000010 

Buffer 

Size 

• 

001000 

LUN #4 

• 

• 



Device 

Name 

• 

SY: 

Device 

Flags 

• 

• 

000010 

Buffer 

Size 

• 

• 

001000 

LUN #5 

• 

• 



Device 

Name 

• 

• 

SY: 

Device 

Flags 

• 

• 

000010 

Buffer 

Size 

• 

• 

001000 

LUN #6 : 




Device 

Name 

• 

• 

SY: 

Device 

Flags 

• 

• 

000010 

Buffer 

Size 

• 

• 

001000 

LUN #7 ; 

» 



Device 

Name 

• 

• 

SY: 

Device 

Flags 

• 

• 

000010 

Buffer 

Size 

• 

• 

001000 

LUN #8 : 




Device 

Name 

• 

• 

SY: 

Device 

Flags 

• 

• 

000010 

Buffer 

Size 

• 

• 

001000 

LUN #9 : 




Device 

Name 

• 

• 

SY: 

Device 

Flags 

• 

• 

000010 

Buffer 

Size 

• 

• 

001000 


Flags are: 

Directory 

(512. ) 


Flags are : 

Directory 

(512. ) 


Flags are : 

Directory 

(512. ) 


Flags are : 

Directory 

(512.) 


Flags are : 

Directory 

(512.) 


Flags are : 

Directory 

(512.) 


Flags are : 

Directory 

(512. ) 


Flags are : 

Directory 

(512.) 
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Device 


Device 


Device 


Device 


Device 


Device 


Device 


Device 
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LUN #10: 


Device 

Name 

« 

• 

SY: 



Device 

Flags 

• 

000010 

Flags are : 






Directory 

Device 

Buffer 

Size 

• 

• 

001000 

(512.) 


LUN #11 

• 

• 





Device 

Name 

• 

• 

SY: 



Device 

Flags 

• 

• 

000010 

Flags are : 






Directory 

Device 

Buffer 

Size 

• 

• 

001000 

(512.) 


LUN #12 

• 





Device 

Name 

• 

• 

SY: 



Device 

Flags 

• 

• 

000010 

Flags are : 






Directory 

Device 

Buffer 

Size 

• 

• 

001000 

(512.) 



8 Job Keyword : 
Value : 103300 


User Controlled : 00 

Run-Time System Controlled : 

Post-Mortem Dump Enabled 
Traps Enabled 
No Temporary Privileges 


System Controlled : 


JFFPP 

JFPRIV 


9 Job's FIRQB : 

IOSTS: 000 ( 0. ) 

FIRQB: 

000000 

010074 

000034 

000401 

006273 

034330 

021042 

000021 

001000 

000000 

100000 

024010 

041104 

176001 
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013560 

000000 

Job's XRB : 
000002 
000020 
000020 
000020 
000711 
177770 
000001 
000000 
000000 


10 Job's Core Common : 

Length : 8 

T K B @ F 0 0 

124 113 102 040 100 106 117 117 


11 User Assignable PPN : <None> 

User Default Protection : <None> 
User Logical Name Table : 

<Table Empty> 

12 Initial PC : 002000 
Initial PS : 174017 


13 Registers at time of Dump : 


R0 

R1 

R2 

R3 

R4 

R5 

SP 

PC 

PS 

14 Job's Stack : 

Initial SP = 


000040 

004020 

121030 

002372 

002112 

001774 

001762 

120150 

000000 


002000 Final SP 


= 001762 


SP 

i 

V 

001762 / 000000 121036 174000 101744 002112 000001 003770 004437 


15 Post-Mortem Dump of SY:[1,201]PMD030.PMD on 13-Jun-85 at 09:15 AM 
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Memory Dump, in Octal 


00 02 04 06 10 12 14 

000000 / 023747 000000 026226 000000 000041 000000 000000 

000020 / 000000 100124 000000 010000 000000 000000 000100 

000040 / 000014 000000 000000 000001 000000 002372 004044 

000060 / 176347 002620 000450 000700 000000 010000 000170 

000100 / 174000 001740 003400 000000 000000 017112 112561 

000120 / 146264 023032 115635 061043 066063 013032 110664 

000140 / 106063 053072 115704 061063 006063 017112 112561 

000160 / 146264 023032 115635 061043 066063 000000 000000 

000200 / 044524 177777 000007 000200 054523 177777 000010 

000220 / 054523 177777 000010 001000 054523 177777 000010 

000240 / 054523 177777 000010 001000 054523 177777 000010 

000260 / 054523 177777 000010 001000 054523 177777 000010 

000300 / 054523 177777 000010 001000 054523 177777 000010 

000320 / 054523 177777 000010 001000 054523 177777 000010 

000340 / 054523 177777 000010 001000 000000 000000 000000 

000360 / 000000 000000 000000 000000 054523 177777 000010 


00 02 04 06 10 12 14 

000400 / 103300 000000 010074 000034 000401 006273 034330 

000420 / 000021 001000 000000 100000 024010 041104 176001 

000440 / 000000 010000 010000 000000 000036 000000 000000 

000460 / 052010 041113 040040 047506 000117 042057 046525 

000500 / 047516 040515 000120 000000 000000 000000 000000 

000020 / 000000 000000 000000 000000 000000 000000 000000 

000540 / 000000 000000 000000 000000 000000 000000 000000 

000560 / 000000 000000 000000 000000 000000 000000 000000 

000600 / 000000 000000 000000 000000 000000 000000 000000 

000620 / 000000 000000 000000 000000 000000 000000 000000 

000640 / 000000 000000 000000 000000 000000 000000 000000 

000660 / 001742 000002 000020 000020 000020 000711 177770 

000700 / 000000 000000 000000 000000 000000 000000 000000 

000720 / 000000 140300 000000 001774 002000 174017 000000 

000740 / 000000 000000 000000 000000 000000 000000 000000 

000760 / 000000 000000 000000 000000 000000 000000 000000 


00 02 04 06 10 12 14 

001000 000000 000000 000000 000000 000000 000000 000000 
001020 / 000000 000000 000000 000000 000000 000000 000000 

001040 / 000000 000000 000000 000000 000000 000000 000000 

001060 / 000000 000000 000000 000000 000000 000000 000000 

001100 / 000000 000000 000000 000000 000000 000000 000000 

001120 / 000000 000000 000000 000000 000000 000000 000000 

001140 / 000000 000000 000000 000000 000000 000000 000000 
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16 

000000 

000100 

000000 

166214 

064143 

061063 

064243 

000000 

001000 

001000 

001000 

001000 

001000 

001000 

000000 

001000 


16 

021042 

013560 

000000 

027520 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000001 

000000 

000000 

000000 

000000 


16 

000000 

000000 

000000 

000000 

000000 

000000 

000000 
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001160 

/ 

000000 

000000 

001200 

/ 

000000 

000000 

001220 

/ 

000000 

000000 

001240 

/ 

000000 

000000 

001260 

/ 

000000 

000000 

001300 

/ 

000000 

000000 

001320 

/ 

000000 

000000 

001340 

/ 

000000 

000000 

001360 

/ 

000000 

000000 




00 

02 

001400 

/ 

000000 

000000 

001420 

/ 

000000 

000000 

001440 

/ 

000000 

000000 

001460 

/ 

000000 

000000 

001500 

/ 

000000 

000000 

001520 

/ 

000000 

000000 

001540 

/ 

000000 

000000 

001560 

/ 

000000 

000000 

001600 

/ 

000000 

000000 

001620 

/ 

000000 

000000 

001640 

/ 

000000 

000000 

001660 

/ 

000000 

000000 

001700 

/ 

002322 

000000 

001720 

/ 

174000 

100330 

001740 

/ 

120230 

000040 

001760 

/ 

120150 

000000 




00 

02 

002000 

/ 

004437 

100212 

002020 

/ 

000002 

000000 

002040 

/ 

003772 

003762 

002060 

/ 

047506 

020117 

002100 

/ 

144302 

003770 

002120 

/ 

000000 

000000 

002140 

/ 

101550 

142064 

002160 

/ 

101550 

142742 

002200 

/ 

101550 

141724 

002220 

/ 

101550 

141622 

002240 

/ 

000000 

000000 

002260 

/ 

000000 

000000 

002300 

/ 

000000 

000000 

002320 

/ 

000000 

000000 

002340 

/ 

000000 

000000 

002360 

/ 

000000 

000000 


././. 


000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

04 

06 

10 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

001726 

004070 

002016 

174000 

163046 

002372 

004020 

121030 

002372 

121036 

174000 

101744 

04 

06 

10 

002034 

004012 

001000 

002122 

000000 

003762 

000004 

004014 

000002 

020040 

117172 

000012 

101732 

000001 

121030 

000000 

000000 

000000 

101550 

101550 

101550 

101550 

101550 

101550 

101550 

101550 

101550 

101550 

101550 

101550 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

/. 

--/— 

./ 


000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 


12 14 16 

000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 001722 100330 
000071 000032 000170 
002112 001774 001762 
002112 000001 003770 


12 14 16 

004070 002322 002120 
000000 002066 003772 
004020 002000 000000 
144306 000040 003770 
117172 077777 125630 
141622 101550 101550 
142252 101550 101550 
141724 101550 101550 
141622 101550 101550 
101550 101550 101550 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 
000000 000000 000000 

./. 
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00 

02 

04 

007400 

/ 

000000 

000000 

000000 

007420 

/ 

000000 

000000 

000000 

007440 

/ 

000000 

000000 

000000 

007460 

/ 

000000 

000000 

000000 

007500 

/ 

000000 

000000 

000000 

007520 

/ 

000000 

000000 

000000 

007540 

/ 

000000 

000000 

000000 

007560 

/ 

000000 

000000 

000000 

007600 

/ 

000000 

000000 

000000 

007620 

/ 

000000 

000000 

000000 

007640 

/ 

000000 

000000 

000000 

007660 

/ 

000000 

000000 

000000 

007700 

/ 

000000 

000000 

000000 

007720 

/ 

000000 

000000 

000000 

007740 

/ 

000000 

000000 

000000 

007760 

/ 

000000 

000000 

000000 


06 10 12 14 16 

000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 
000000 000000 002000 000000 000000 
000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 
000000 000000 000000 002376 000000 
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Submitting Requests 


to the OPSER-Based Spooler: 


The QUE Program 


The QUE system program submits requests (jobs) to the OPSER-based 
spooling programs. QUE also performs auxiliary operations such as 
listing, killing, or modifying pending requests. QUE checks the 
syntax and validity of each request and, if the request is valid, 
passes it to another program for further processing. If the request 
is invalid, QUE rejects the entire request, displays an error message, 
and allows you to try again. 


To execute a request submitted to QUE, the system must contain three 
additional programs: 


Program 

QUEMAN 

OPSER 


spooling 



Description 

The queue manager program. It processes a request created 
by QUE and places it in the system queue file. 

The Operator SERvices program, which provides 
communication between the operator and the spooling 
programs. 

The particular spooling program executes requests on its 
related device when QUEMAN passes a pending request to it. 
Valid spooling devices and their accompanying standard 
RSTS/E system programs are: 


Device 


Name 


RSTS/E program 


LP: 

BA: 

RJ: 


Line Printer 

Batch 

RJ2780 


SPOOL 

BATCH 

RJ2780 (optional) 


Privilege Required 

To run QUE, you need the following: 

o Read access to input files. 

o Write access to files specified with the /DE (delete) switch 

o GACNT or WACNT privilege to submit requests under a PPN other 
than your own 
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Running QUE at a Terminal 
To run the QUE program, type: 

$ RUN OPSER$:QUE 

QUE displays an identifying header followed by a number sign (#) 
prompt to indicate its readiness to accept commands. QUE also 
displays the # prompt after processing each command. 

If your system manager has defined a CCL command for the queue 
program, QUE for instance, you can invoke the queue program by typing 
$QUE. 

If QUE runs, and finds an error when accessing the queue file, the 
program displays the following error message: 

?Queue not initialized 

If this occurs, ask your system manager run the QUEMAN program to 
initialize the queue file. 

You can terminate QUE by typing E or entering CTRL/Z in response to 
the # prompt as follows: 

#E 

$ 

QUE returns control to the keyboard monitor command level and the 
corresponding prompt (in this case, $). 

The following sections explain the commands to queue, list, kill, and 
modify jobs. 
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Table 2-18 summarizes the QUE commands. 
Table 2-18: QUE Program Commands 


+ 

1 

Command 

1 


Format 

1 

Description 

1 

+ 

1 


1 



1 


1 

1 

1 

QUE 

1 

1 

Q 

device:jobname=file spec(s) 

1 

I 

Specifies one or more 

1 

1 

1 


1 



1 

files you want to 

1 

1 


1 



1 

process. Use a comma to 

1 

1 





1 

separate multiple file 

1 

1 


1 



1 

1 

specifications. 

1 

1 

1 

1 

LIST 

1 

1 

L 

device:»jobname(s) 

1 

1 

Displays a list of the 

1 

1 

1 


1 



1 

currently pending 

1 

1 


1 



1 

requests for the 


1 


1 



1 

spooling program on 

1 

1 


1 



1 

your terminal. If you 

1 

1 


1 



1 

omit device:, QUE 

1 

1 


1 



1 

assumes LPO:. If you 

1 

1 


1 



1 

omit device: but 

1 

1 


1 



1 

specify jobname(s), you 

1 

1 


j 



1 

must include the * 

1 

1 


1 



1 

symbol. Valid devices 

1 

1 


1 



1 

are: 

1 

1 


1 



1 

LP: 

1 

1 


1 



1 

LPO:-LP7: 

1 

1 


I 



1 

BA: 

1 

i 


1 



1 

BAO:-BA7: 

1 

1 


1 



1 

RJ: 

1 

1 


1 



1 

Specifying LP: or BA: 

1 

1 


I 



1 

indicates all units of 

1 

1 


1 



1 

that device. If you do 

1 

1 


1 



1 

not include a jobname, 

1 

1 


1 



1 

QUE displays all jobs 

1 

1 


1 



1 

for the specified 

I 

1 


1 



1 

device. 

1 

1 

1 

1 

SHORT 

1 

1 

S 

device:*jobname(s) 

1 

1 

Same as the L (LIST) 

1 

1 

1 


1 



1 

command, except that 

1 

1 


1 



1 

QUE displays a short 

1 

1 


I 



1 

form list of the 

1 

1 


1 



1 

currently pending 

! 

1 


1 



1 

requests for the 

1 

1 


1 



1 

spooling program on 

1 

1 


1 



1 

your terminal. 

1 
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Table 2*18: QUE Program Commands (Cont.) 


+ ■ 

1 

Command 

1 


Format 

1 

Description 

1 

+ 

1 


1 



1 


1 

1 

1 

KILL 

1 

1 

K 

device:=jobname(s) 

1 

1 

Removes one or more 

1 

1 

1 


1 



1 

jobs you indicate in 

1 

1 


1 



1 

the device 

1 

1 


1 



1 

specification and 

1 

1 


1 




jobname. If you omit 

1 

1 


1 




device:, QUE assumes 

1 

1 


1 



1 

LPO:. If you omit 

1 

1 


1 



1 

device: but specify 

1 

1 


1 



1 

jobname, you must 

1 

1 

1 


1 

1 



1 

1 

include the ■ symbol. 

1 

1 

1 

1 

MODIFY 

1 

1 

M 

device:jobname/switch(es) 

1 

1 

Modifies the parameters 

1 

1 

1 


1 



1 

of a job already in the 

1 

1 


1 



1 

queue. With the M 

1 

1 


1 



1 

(MODIFY) command you 

1 

1 


1 



1 

can modify these 

1 

1 


1 



1 

parameters: 

1 

1 


1 



1 

*o Priority 

1 

1 


1 



1 

o Forms name 

1 

1 


1 



1 

o After date or time 

1 

! 


1 



1 

o Forms control type 

1 

1 


1 



1 

o Number of job 

1 

1 


1 



1 

copies 

1 

1 


1 



1 

o Job status 

1 

1 


1 



1 

o Mode 

1 

1 

1 

FLUSH 

1 

1 

F 

dev: 

1 

1 

Directs QUE to abort 

1 

1 

1 


1 

F 

BA: 

1 

all current jobs in the 

1 

1 


1 



1 

queue. BA: specifies 

1 

1 


1 



1 

the OPSER-based Batch 

1 

1 


1 



1 

Processor, dev: 

1 

1 


1 



1 

specifies a line 

1 

1 


1 



1 

printer unit (LPO: is 

1 



1 



1 

the default). If you 

1 

1 


1 



1 

specify LP: with no 

1 

1 


1 




unit number, QUE aborts 

1 

1 


1 



1 

all jobs in any device 

1 

1 


1 



1 

queue. The F (FLUSH) 

1 

1 


1 


' 

1 

command is available 

1 

1 


1 



1 

only to the users 

1 

1 


1 



1 

defined in the OPSER 

1 

1 


1 



1 

operator table. 

1 
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Table 2-18: QUE Program Commands (Cont.) 


+ 

1 

Command 

1 

Format 

1 

Description 

t 

+ 


1 


1 


1 

1 

1 

HELP 

1 

1 

H 

1 

1 

Displays an 

1 

1 

1 


1 


1 

informational message 

1 

1 


1 


1 

on your terminal. 

1 

1 

1 

1 

EXIT 

1 

1 

E 

1 

1 

Terminates QUE and 

1 

1 

1 


1 


1 

returns control to 


1 

1 


1 

1 


1 

1 

system command level. 

1 

1 

1 

1 

CTRL/Z 

1 

1 

Enter CTRL/Z 

1 

1 

Terminates QUE and 

1 

1 

1 


1 



returns control to 

i 

1 


1 


' 1 

system command level 

l 

1 


1 


1 

(same as E [EXIT] 

l 

1 

+ - 


1 


1 

command). 

l 


Using the Q Command 

Type Q in response to the number sign (#) prompt to request a spooling 
program. The Q command has the following general format: 

Q device:jobname/sw*file spec, file spec,..., file spec 

where: 

device: designates the device and unit number that the spooling 

program services. The device can be: 

LPn: 

BAn: 

RJ: 

where n is an integer between zero and seven. 

If you do not specify a device, LPO: is the default. LP: 
and BA: direct QUE to send the request to any available 
spooling program for that device type. If you specify a 
device, you must also specify the = symbol. 

If you specify a unit number with device LP: or BA:, QUE 
designates the request for that unit. QUE executes the 
request only if a spooling program is running on that 
unit. If you do not specify a unit number with device 
LP: or BA:, QUE sends the request to the first available 
device. 
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The general OPSER-based Batch Processor BA: processes 
only those jobs queued for BA: and not jobs queued for 
BAO: - BA7:. However, BATCH processors BAO: - BA7: 
process requests queued for their respective units as 
well as requests queued for BA:. 

jobname identifies your request in the queue. Jobname can be a 
maximum of six alphanumeric characters. If you do not 
specify jobname, QUE uses the name of the first file you 
specify in the request. 

If you have GACNT or WACNT privilege, you can specify an 
account with jobname. The account must be a valid user 
account on the system disk. If you do not specify an 
account, the program queues the request under your 
current account. Both your account and the account you 
specify must have access to any files you include in the 
request. 

/sw specifies one or more switches that determine the output 

characteristics of the entire request. See Table 2-19. 

* associates the specified device and jobname with the 

files you want to process. If you do not specify a device 
and jobname, the » symbol is optional. 

file spec specifies the file QUE processes from the queue and 

can include any combination of Q command switches. You 
can include up to 11 files in a request. No file can be 
larger than 32767 blocks. Use a comma (,) to separate 
each file specification. See the section "Q File 
Specifications" for a complete description of 
specification options and available switches. 

Table 2-19 lists the Q command output switches. 

Table 2-19: Q Command Output Switches 


+.+. 

| Switch | Format 

+.+. 


Mode 


/MO:n 


+.-.+ 

| Description | 

+.+ 

I I 

| The value n specifies the MODE I 
| that the spooling program uses | 

j in its OPEN statement for the j 

j line printer (see the RSTS/E j 

j Programming Manual ). You can j 

| use the following specific MODE j 
j switches instead of /MODE: n) . 
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Table 2-19: Q Command Output Switches (Cont.) 


Switch 

| Format 

| Description 


I 

1 

Length 

| /LE:nnn 

1 

1 

| Set form length to nnn (1 to 
j 127) lines per page. 

Convert 

1 /CO 

1 

1 

I 

| Change number 0 (zero) to 

| letter 0 ( oh ). 

1 

Truncate 

1 /TR 

1 

1 

| Truncate lines longer than 
j unit's configured length. 

Line printer 
form 

1 /LP 

| Enable software formatting. 

I 

Uppercase 

1 /UP 

1 

1 

| Translate lowercase to 

j uppercase characters. 

1 

Skip 

1 /SK 

1 

1 

| Skip six lines at bottom of 
| each form. 

i 

After 

1 

| /AFispec 

1 

1 

1 

1 

| Initiate the current request 
j after the value given in spec, 
j Spec can be one or more of the 
j following: 


dd - mmm - yy hh: mm 

yy.mm.dd hh:mm:am/pm 


+n D[AYS ] +n H[OURS] 


Priority 


/PR:n 


QUE sets the priority to the | 
value of n, which can be in the j 
range 0 and 255. The default j 
priority is 128. If you have | 
EXQTA privilege or are defined | 
in the OPSER operator table, | 
you can specify a priority | 
between 0 and 255. Otherwise j 
you can specify a priority [ 
between 0 and 127. The priority j 
setting determines the job's j 
place in the queue; the higher | 
the number, the higher the j 
priority. If two or more jobs j 
have the same priority, they go j 
to the spooler in order of job j 
requests. j 
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Table 2-19: Q Command Output Switches (Cont.) 


+ - - 






1 

+ - - 

Switch 

1 

Format 

1 

Description 


Type 


Forms 


Job copies 


+ 


/TY:xxx 


/FO:<form name> 


/JC:n 


+ 


Use the format specified by xxx 
for printing the file. Value 
can be: 

FTN FORTRAN forms control 

EMB Embedded forms control 

IMP Implied forms control 

IMP (LF and CR printed 

before each record). 

String <form name> specifies 
the name of the form on which 
the job is printed; <form name> 
cannot exceed six characters, 
and the first character cannot 
be a digit. The default is 
NORMAL. 

The value of n specifies is the 
number of job copies you want 
to print. If you omit this 
switch, QUE prints one copy of 
the job. 


Note 


You can also specify file name switches /CO:nn, /NH, 
/DE, and /BI as job switches. When used as job 
switches, they apply to all files in the job. See 
Table 2-20 for a description of these switches. 


The /AFTER switch directs the queue manager to initiate a job request 
sfter a particular date and time. The /AFTER switch arguments that 
specify the date and time have one or more of the following formats: 


Name Format 

Calendar /AF:dd-mmm-yy 

date 


Nume ric /AF:yy.mm.dd 

date 


Description 

dd is the date, mmm are the first three 
letters of the month, and yy is the 
year. If you omit the year 
specification, the default is the 
current year. 

yy is the year, mm is the number of the 
month, and dd is the day. 
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Name 

Format 

Description 

Relative 

date 

/AF:+n D[AYS] 

n is the number of days from the current 
date. 

Military 

time 

/AF:hh:mm 

24-hour time, where hh is the hour and 
mm is the minute. 

AM/PM 

time 

/AF:hh:mm am/pm. 

hh is the hour, mm is the minute, and am 
or pm designates before or after noon. 

Relative 

time 

/AF:+n H[OURS) 

n is an integer in the range of 0 to 24. 


The date and time specifications you use with the /AFTER switch are 
subject to the following restrictions: 


o When you use a date specification (calendar, numeric, or 

relative) without a time specification, the job begins after 
midnight on the specified date. 

o You can use only one specification of each type. For 

example, you cannot use a relative date with a calendar date 
or a relative time with a military time. 

o You can concatenate a date specification and a time 
specification. For example, /AF:dd-mmm-yy:hh:mm. 

o When you use a relative time of 0 with a relative date 

specification, the job begins after the current time on the 
date specified. For example, assume you type the following 
option at 3 PM on September 12: 

/AFTER:+2 DAYS:+0 HOURS 

Que initiates the job after 3 PM on September 14. 


Q Command File Specifications 

The file specification part of the Q command line can be a full RSTS/E 
file specification of the following format: 

device:filename.type[proj,prog]/sw/sw... 
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where: 
device: 


filename.type 


[proj,prog] 


/sw 


specifies a valid disk device. The default is the 
system device in the public structure. If you 
assign a logical name before you run QUE, the 
program successfully interprets the logical name: 
otherwise, you receive the error message 
?Illegal input file. See the RSTS/E System 
User's Guide for a discussion of logical names. 

specifies the file name and type. The default 
file type is .LST for print queues and .CTL for 
batch queues. You can specify the * and ? 
wildcard characters for the file name and type. 

See the section "Using Wildcard Character." 

specifies a PPN of the file you want to print. The 
default is the current account. You cannot use 
wildcard characters in the PPN. 

specifies one or more Q command switches. See 
Table 2-20 for a description of the switches. 


Using Wildcard Characters in File Specifications 


When you specify a wildcard character for a file name or file type 
field: 


o The * character replaces an entire field 

o The ? character replaces a single character within the field 


Specify wildcard characters in the following manner: 


Specification 


Result 


FILE.* All files with the name FILE and any type. 

*.TYP All files with the type .TYP. 

*.* All files. 


FILE.TY? All files with the name FILE and TY as the first two 

characters of the file type. The third character is 
any character including blank. 
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Specification 
FILE??.TYP 

FILE??.T?? 

AB?.TYP 

FILE??.* 


Result 

All files with four- to six - character names, the 
first four of which are FILE, and a file type of 
TYP. 

All files with four- to six - character names, the 
first four of which are FILE, and any type whose 
first character is T. 

All files with two- to three-character names, the 
first two of which are AB, and a file type of TYP, 

All files with four- to six - character names, the 
first four of which are FILE, and any type. 


*.TY? All files of any name whose type begins with TY. 

Table 2-20 lists and describes the Q command file name switches. 
Table 2-20: Q Command File Name Switches 


Switch 

| Format 

| Meaning 

Copies 

1 

| /CO:n 

1 

1 

1 

1 

| SPOOL prints the number of copies indicated 
| by the decimal integer n. If you do not 

| specify /COrn, SPOOL prints one copy. 

1 

No Header 

1 /NH 

1 

1 

| SPOOL suppresses printing of the file header. 

1 

Delete 

1 /DE 

1 

1 

1 

j SPOOL deletes the file after it is printed, 

| if the protection code of the file permits, 
j The QUEMAN program checks the protection code 
| of the file. You cannot use /DE with file 
j specifications that include wildcards. 

More 

1 

| /MORE 

1 

1 

I 

1 

| Indicates to QUE that you have more text to 
| type on the next physical line. Used only at 
j the end of a command line. 

I 

Binary 

1 

1 /BI 

1 

I 

| Indicates a binary file to the RJ2780 
| program, which must be in transparent mode. 

i 

Restart 

1 /RE 

1 

1 

| SPOOL restarts the file or job if a 
j malfunction occurs in printing. 


2-159 










System Utilities 
QUE 


Q Command Examples 

Consider the following Q command: 

#Q ABC.DAT 

QUE sends file ABC.DAT, stored in your current account, to the queue 

manager for spooling to LPO:. SPOOL generates one copy of the file 

under job header ABC. 

To queue a file from a device other than the public disk, specify the 
device designator in the command. For example: 

#Q DK1:A.BAS/CO:2 

Que sends file A.BAS on disk DK1: to line printer unit 0. SPOOL 

generates two copies of the file under job header A. 

To specify a job name for the request, type the name and the equal (=) 
symbol in the command. For example: 

#Q S0RT=DK1:FILEA,FILEB/CO:2 

In this example, SPOOL prints SORT in the job header and generates one 
copy of DKl:FILEA.LST and two copies of DKl:FILEB.LST. 

To specify a spooling program other than the one for line printer unit 
0, type the appropriate designator and the - symbol in the command. 

For example: 

#Q LPl:“DKl:FI LOUT .001 

In this example, QUE creates a request for FILOUT.OOl on line printer 
unit 1, and assigns the job name FILOUT. 

To specify a request that includes an account other than your own, 
type the PPN after the output device. For example: 

#Q LPO:[1,10]-ABC.DAT 

In this example, QUE creates a request to print file ABC.DAT, located 
in your current account, and queues the request under account [1,10]. 
You must have WACNT privilege, or GACNT privilege if the PPN you 
specify is in the [1,*] group. Account [1,10] must have Read access 
to file ABC.DAT. 

To specify a request longer than one physical line, type the /MORE 
switch as the last item on the line. For example: 

#Q LPl:PRINTl-FILEl.001,ABCDEF.001,/MORE 
MORE > HELP.TXT,ACCT.SYS 
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As a result, QUE displays the MORE > prompt, after which you can 
continue typing the request. QUE allows up to eleven files in one 
request. Type /MORE as many times as necessary. Note that /MORE is 
invisible to the parser; QUE interprets the completed command as if it 
were typed on one line. Therefore, you must place all punctuation 
(commas, colons, and so on) in the appropriate positions. 

When you specify a device designator in the command, QUE uses that 
device (and not the system device) as a default for subsequent input 
file names on the physical line. For example: 

#Q LP1:SORT=DK2:FILEA,FILEB 

When QUE executes the previous command, the program sets the device to 
DK2: for both FILEA.LST and FILEB.LST. Because you did not specify a 
device designator for FILEB, DK2: is the default device. 

To assign a priority to a job when queuing a file, specify the /PR:n 
switch with a value for n in the range of 0 to 255. Without the /PR 
switch, QUE assigns a priority of 128 to the job. The queue 
management program processes jobs with a priority of 128 or greater 
before processing jobs less than 128. With such a priority scheme, 
the queue manager can process important jobs before routine jobs and 
can delay processing less important jobs until routine jobs are 
completed. Scheduling is a function of priority; if you submit a 
high-priority batch job that runs for a long time, the job delays 
other jobs submitted to the same spooler. 


Using the L and S Commands 

The L command displays information on your terminal about pending 
requests for a specified device. The command line has the format: 

L device:=jobname(s) 

For a complete description of the device: and jobname specifications, 
see the section "Using the Q Command." 

The following example shows the use of the L command: 

#L LPO: 

LPO QUEUE LISTING 13-Jun-85 04:12 PM 

UNIT JOB S / P FILES 

0 NOTICE[2,201]/SE:1038/FO:NORMAL 

SK/128/TY:EMB 

SY :[1,2]NOTICE.TXT 
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0 BNFTRNf2,201]/SE:10 39/FO:NORMAL 

0 /128/TY:EMB 

SY :[2,201JBNFTRN.SIF 
SY :[2,201JBNFBLD.SIF 
SY :[2,201JPERCNT.BAS 

0 VISITS!2,201]/SE:104O/FO:NORMAL 

0 /128/TY:EMB 

SY :[2,201]VISITS.LST 

The L command causes QUE to display two header lines for the specified 
spooled device. The first header line contains the device and unit 
designator of the specified device (LP0: by default), the current 
system date, and the time of day. The second header line contains 
headings that denote the unit to which the file has been queued, the 
jobname and account number of the requester, and the status, priority, 
and full file specifications associated with each job. If no jobs are 
queued, QUE displays: 

dev: Queue is empty 

QUE displays jobs in the order in which QUEMAN accesses them. In the 
first line of each job description, the jobname precedes its account 
number and the sequence number (/SE:n) assigned to the job by QUEMAN. 
The /FO[RMS]:n switch follows the sequence number. Argument n refers 
to the name you specify, or the default NORMAL. 

The status appears under the heading S in the second line of each job 
description. The status indicators are: 

Status Meaning 

0 Job is in queue waiting to be processed. 

S Job has been sent to spooler. 

A Job is waiting for an /AFTER datetime to expire. 

H Job is in hold status: it has been modified (by the M 

command) to be put into hold, or it was put into hold if 
QUEMAN restarted and found that the job was previously sent 
to the spooler. 

K Job is in kill status. 

Some status indicators may appear together; for example, SK means that 
the job was sent to the spooler, and that a K command was later issued 
for it. 

P for Priority (0 to 255) appears next on the second line; 128 is the 
default. Following the priority are any job switches you specify. 
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Appearing under the lines describing a job are the descriptions of 
individual files in that job--the full file specifications followed by 
any file switches you specify. 


Note 

Because both QUE and QUEMAN can access a queue list 
simultaneously, QUE tests the linkage of the queue 
list to verify that QUEMAN did not change the queue 
list during QUE's search. If QUE detects that the 
linkage has changed, QUE displays the following 
message and restarts the listing from the beginning of 
the queue list: 

*****queue changing--will restart listing***** 


To list jobs on all line printers, type: 

#L LP: 

QUE displays the related unit number in the UNIT column for each 
queued job. To display jobs queued for the Batch Processor, type the 
L BA: command; to display jobs queued for the RJ2780 program, type L 
RJ: . 

To list only information about one request or several requests, 
include the * symbol followed by the jobname(s) in the L command. In 
the following example, QUE displays the header lines and the data for 
the jobname specified: 

#L LPO:=REW[ 200,57] 

LPO QUEUE LISTING 09-Jun-85 03:22 PM 

UNIT JOB S / P FILES 

0 REW[200,57]/S E:2 7 7 5/FO:NORMAL 

S 128TY:EMB 

SY :[200,57]EXPENS.BAS 
SY :[200,57]VISITS.LST/C:3 

If you specify more than one jobname, separate them by commas, as in 
the following example: 

i 

#L LPO:=REW[ 200,57] , REF[ 200,57] 

LPO QUEUE LISTING 13-Jun-85 03:22 PM 

UNIT JOB S / P FILES 

0 REW[200,57]/SE:2775/FO:NORMAL 

A 128/TY:EMB 

SY :[200,57]EXPENS.BAS 
SY :[200,57]VISITS.LST/C:3 
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0 


REF[200,57]/SE:2776/FO:NORMAL 

S 128/TY:EMB 


SY :I 200,57]CHOICE.BAS/C:3/N 
SY :[200,57]CURZ.LST/C:7/D 


The S command lists, in a shortened form on your terminal, information 
about pending requests for a specified device. The command line has 
the same format as the L command line, described earlier in this 
section. 

The following example shows the command and its result: 


#S LP0: 

LP0 SHORT QUEUE LISTING 15-Jun-85 
UNIT JOB 

0 NEWV05[1,234]/SE:1374/FO:NORMAL 

0 RMSTST[2,211]/SE:1375/FO:NORMAL 


11:25 AM 


S / P 
S /128 
0 /128 


Unlike the L command, the S command directs QUE to display a "short 
queue listing" header line followed by a single line description of 
each job in queue. The single line description contains the following 
information: 

o Jobname 

o Job account number 
o Sequence number (/SE:) 
o /FORMS switch, argument (/FO:n) 
o Job status 
o Job priority 
o /AFTER time specified 

Using the K Command 

The K command removes one or more jobs from the queue of a specified 
device. To remove a job, specify a command in the following format: 

K device:=jobname(s) 

You must be defined as a valid operator to remove any job other than 
your own. 
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For a complete description of the device: and jobname specifications, 
see the section "Using the Q Command." 

The following examples show the use of the K command: 

#K LPl:=PRINTl,BATCHl 

This command instructs QUE to delete from the queue on line printer 
LPl: each job with the name PRINTl or BATCHl under your account if the 
spooling program is not currently processing the job. 

In the case of matching jobnames, specify the job you want to remove 
from the queue by including the /SE:nnnnn switch in the K command. 

The argument nnnnn represents the job's sequence number. You can find 
out the sequence number for a job by using the L command (see the 
previous section). This example shows the use of the /SE switch: 

#K LPl:=PRINT1/SE:1475 


Using the M Command 

The M command lets you modify the parameters of a job that is already 
in the queue. By including the M command with appropriate switches, 
you can modify the job parameters originally set in the Q command; for 
example, priority, mode., date/time, number job copies, form, and type. 
However, if the job has already been sent to a spooling program, 

QUEMAN does not allow any modifications. 

You must be defined as a valid operator to modify any job other than 
your own. 

To specify modifications to the job, type the device designator 
followed by the jobname and the desired modification switches in the 
following format: 

M device:jobname/switch(es) 

The following list contains job modification switches that you can 
specify with the M command. Except where otherwise indicated (for 
example /HOLD and /UNHOLDj, these switches correspond in name, 
function, and format to those of the Q command. 
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Switch 

Format 


Description 


Hold 

/HO 

Halt the job 
do not send 
the /UNHOLD 

's advancement in the queue, and 
it to a spooling program until 
switch is specified. 

Unhold 

/UNHO 

Continue the 

job's advancement in 

the queue. 

Sequence 

/SE:nnnnn 

Modify only 

the job with sequence 

number 


nnnnn (assigned by QUEMAN; see the section 
"Using the L and S Commands"). Use this 
switch when there are matching jobnames. 

See Table 2-19 for explanations of the following switches: 

/PR:n 

/MO:n or 

/LEmnn /UP 

/CO /SK 

/TR 
/LP 

/AF: dd-mmm-yy hh:mm 

yy.mm.dd hh:mm am/pm 

+n D[AYS] +n H[OURS] 

/TY:xxx 

/FO:<form name) 

/JC:n 


Running QUE Using CCL Commands 

You can run QUE using a CCL command if your system manager has defined 
one for the QUE program on your system. For example, if the CCL 
command is QUE, the command format is: 

QUE/<command lino 

The <command lino can be any valid QUE program command. If QUE does 
not find a slash (/) character immediately following the word QUE, the 
program assumes the command is a Q command. For example, the 
following two commands are identical: 

QUE/Q J0B1-ABC.DAT 

QUE JOBl-ABC.DAT 
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These commands are the same because both enter JOBl in the queue for 
line printer 0. In either case, QUE runs, executes the command, and 
exits. An error in the command causes QUE to display the related 
error message on a subsequent line, and then exit. 

To include an output switch when queuing a job, use /Q in the QUE 
command line or specify an explicit jobname in the QUE command. For 
example: 

QUE/Q/MODE:2048=DK1:DISK.BAS 

The / character before the Q character marks the distinction between 
the Q command and the jobname Q. 

To list or kill jobs, type QUE, followed by a / character and the 
appropriate command. For example: 

$ QUE/L DISPLY[1,253] 

LPO QUEUE LISTING 13 -Jun-85 03:22 PM 

UNIT JOB S / P FILES 

0 DISPLY[1,253]/SE:558/FO:NORMAL 

0 /128/TY:EMB 

SY :[1,253]DISPLY„V6B 


$ 

QUE runs and executes the command indicated following the / character, 
after which it returns control to the system command level. 


Error Messages and Codes 

QUE reports an error condition by displaying a message or by returning 
an error code. When running at a terminal, QUE displays a unique 
message that describes the error condition. 

When QUE finds an error, it does not execute any part of the command. 
You must .retype the entire command. 

QUE returns- the error message Tlllegal input file when it finds any 
RSTS/E system error. When running by means of a CHAIN operation from 
a BASIC-PLUS program, QUE reports an error by displaying an error code 
when it passes control. 
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Table 2-21 lists both the messages and codes and describes the related 
error conditions. 

Table 2-21: QUE Error Messages and Codes 


+ - - 


.+ - - - 


Message and Meaning 


’INVALID COMMAND-<text> 

The <text> indicated is an undefined command. 

?SW ON WRONG SIDE OF COMMAND 

You specified a switch on the output side of the 
QUE command line that is reserved for the input 
side, or vice-versa. 

?INVALID SWITCH FORMAT 

The switch contains an invalid request. 

’UNDEFINED SWITCH 

The command line contains an undefined switch. 

’TOO MANY FILES 

You specified more than eleven files in the Q or K 
command. 

’NULL FILE SPEC 

You must give at least one file specification in a 
Q or K command and none was found; or you included 
two commas with no file specification between them. 


?ILLEGAL INPUT FILE-<text-- -filespeO 

You specified a file that caused this RSTS error. 
Retype the request. 

7WILDCARDS NOT ALLOWED IN PPN 

You typed an * character in the project-programmer 
field. 

7QUEUE FULL 

The queue file is temporarily full. Try again after 
the spooling program has processed some pending 
requests. 

’BAD SWITCH VALUE-<text> 

There is an invalid or improper number in the 
option indicated by <text>. 


Error 

Code 


10 


11 
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Table 2*21: QUE Error Messages and Codes (Cont.) 


+. 

I 

| Message and Meaning 

+. 


+.+ 

| Error | 

| Code j 

+.+ 


?'MORE' REQUESTED ON A CHAIN 

The /MORE option is not allowed when a program runs 
QUE by a CHAIN operation. 

?NOT A QUEUABLE DEVICE 

You attempted to queue a request to a device which 
cannot handle queued requests. For example: 

Q LG:=JOB. 

’QUEUE NOT INITIALIZED 

The queue file does not exist in the system library 
account. You must run QUEMAN to initialize the 
queue. 


12 


13 


15 


7QUEMAN NOT RUNNING - CAN'T QUE OR KILL 

You have attempted to queue or kill a job and, 
because the queue manager is not running on the 
system, QUE generates an error. You can, however, 
list jobs when QUEMAN is not running. 


16 


’QUEUEING DISABLED 

QUEMAN is in the shutdown process. 


?ILLEGAL SWITCHES FOR CMD 

The specified switches are illegal for the commands 
used. For example, /HOLD and /UNHOLD are illegal 
for Q. 


17 

18 
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Restoring Pre-V9.0 Backed-Up Files: The RESTOR Program 

The RSTS/E RESTOR program lets you return files you backed up before 
RSTS/E V9.0 (using the BACKUP program) to online use. The RSTS/E V9.0 
RESTOR utility includes the restore features previously included in 
the BACKUP utility. 

As you read the following sections, keep in mind that: 

o RESTOR, printed in all uppercase letters, refers to the 

entire package; Restore, with an initial capital only, refers 
to a particular RESTOR operation. 

o RESTOR checks for files that were contiguous when you backed 
them up, and attempts to restore them to their original 
contiguous state. If there is not enough contiguous space on 
the disk, the program does not restore the file. The only 
way to restore the file is to make enough contiguous room for 
it. 


Privilege Required 

To run RESTOR, you need WACNT, WREAD, and WWRITE privileges. 


RESTOR and System Management 

RESTOR provides three operational modes: 

o Restore, to rebuild Backup-created files onto a RSTS/E disk 

o Loadindex, to copy the primary index file from the last 
volume of the Backup Set to a RSTS/E formatted disk 

o List, to print directory information contained in a Backup 
index file 
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How RESTOR Works 

Important characteristics of the RESTOR package are: 
o User dialogue 
o File selection 
o Account creation (optional) 
o File transfer from the backup medium 
o File comparison (optional) 
o List file generation 

The following sections outline the functions RESTOR performs within 
each of these categories. The discussion is limited to Restore 
operations because you should perform new backup operations using the 
DCL command BACKUP. 


User Dialogue 

The dialogue begins when you run RESTOR. The first question asks 
which of the three operational modes you want to perform. If you 
choose, you may create a DCL command file. See the RSTS/E Guide to 
Writing Command Procedures . 

The dialogue then asks you where to create the work file into which it 
will write the directory and error information. Additional questions 
ask for information on which files and accounts to transfer. When the 
dialogue ends, the program writes a summary of your commands into the 
listing file. 


File Selection 

Next, RESTOR searches for all the files and accounts you specified 
during the dialogue phase. In Restore mode, the program.looks up 
files in one of three index files: 

o Primary index file 

o Secondary index file 

o Auxiliary index file 
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The indexes are directories of all the tape or disk volumes of the 
Backup Set. BACKUP writes a primary index file and a secondary index 
file as the last two files on the Backup Set. The third index remains 
in your account; it is called the auxiliary index file. 

The auxiliary index file can be in one of two formats. If the date 
format (selected during system installation) is alphabetic, then the 
format is: 


Bddmmm. 

Jnn 



where: 




B 

indicates Backup 

dd 

is 

the 

date 

mmm 

is 

the 

month 

nn 

is 

the 

job number 


For example, a file named B11JUN.J08 was created for job number 8 on 
June 11. 

If the date format is numeric, the format is: 

Bymmdd.Jnn 
where: 

B indicates Backup 

y is the last digit of the year 

mm is the number of the month 

dd is the date 

nn is the job number 

For example, a file named B40611.J08 was created for job number 8 on 
June 11. 

If you have a multivolume Backup Set, you must load the last volume of 
the set before you load the volumes in succession for the Restore 
operation. RESTOR must have access to the index before it can begin 
restoring a disk. To avoid the need to load the last volume of the 
Backup Set each time you restore a disk, use the Loadindex mode of 
RESTOR. Loadindex places the index on another disk where RESTOR can 
access it. See the section "Load Index File Example" for more 
information. 
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As it makes the selections, RESTOR writes information about each 
selected file and account into the work file. Therefore, the work 
file can become quite large as the selection phase proceeds. The size 
of the work file depends on the number and size of files selected for 
transfer. During the dialogue, you can specify that the work file be 
placed on a private disk to make sure that enough space is available. 

Do not specify a contiguous work or listing file. RESTOR expands both 
these files and the system displays the error message ?Protection 
violation if RESTOR tries to expand a contiguous file past the file's 
initial size. You must make sure enough room is available on the disk 
you specify for - the work and list files. In addition, both files must 
have different names. 

To estimate the size of the work file for RESTOR, consider the 
following guidelines: 

o The work file has a fixed overhead of two to four blocks. 

o Each file you specify requires one-eighth of a block. 

o Each exception also requires one-eighth of a block. See the 
section "File Specification" for a description of the 
exceptions. 

o Errors and file attribute blocks require an additional 
one-eighth of a block each. 

Therefore, for a system of 512 accounts with an average of 16 files 
each (no exceptions) and 16 files with attributes, you can expect the 
work file to contain at least 1094 disk blocks. DIGITAL recommends 
that you add approximately 10% as error space when backing up a large 
system. In this example, therefore, the total is 1204 blocks. 


Account Creation (Optional) 

The Backup Set may contain accounts that do not exist on the disk 
(destination disk) you are restoring. RESTOR asks a dialogue question 
that allows you to reproduce these accounts on the destination disk. 
When you complete the dialogue, RESTOR first creates the selected 
accounts that do not exist on the destination disk and then transfers 
the files (see the following section). Accounts recreated on the 
destination disk retain the same password, quota, and cluster size; 
however, they do not retain the same account names. 



System Utilities 
RESTOR 


The ENTER ACCOUNTS question does not allow you to selectively create 
accounts. RESTOR either creates all the selected accounts on the 
destination disk or creates none of them. If you want to reproduce 
all accounts, accept the default (YES); otherwise, type NO. Note that 
RESTOR does not reproduce any account that did not contain files when 
you backed up that account. 

Note 

Because all account passwords are on the Backup Set, 
protect your Backup Set from access by unauthorized 
personnel. 


File Transfer from the Backup Medium 

When the selection process is complete, RESTOR transfers files in the 
order it finds them on the Backup Set. 

If you include a file specification with the SUPERSEDE dialogue 
question, RESTOR replaces files on the destination volume with the 
backup versions. Accept the NONE default to supersede no files. 

While the default to the SUPERSEDE question is NONE, you must include 
a file specification to override the default. Note that the words ALL 
and YES only make RESTOR try to supersede files named ALL and YES. 

When RESTOR needs a new volume or finds an error, it prints a prompt 
on the job's terminal or (if the job is detached) on the operator 
services console (OSC). RESTOR also logs all errors in the listing 
f ile. 


File Comparison (Optional) 

After it copies the files and accounts, RESTOR compares the original 
files with their duplicates on the Backup Set (if you requested a 
comparison). RESTOR records any differences between the two files in 
the listing file and on the job's console terminal. 

While the default to the COMPARE FILE(S) question is NONE, you must 
include a file specification to override the default. Do not enter 
the words ALL or YES. 


List File Generation 

As the last step, RESTOR generates the remaining listing file text. 
RESTOR lists each file selected for transfer, whether or not the 
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program transfers that file. For example, RESTOR can select a 
zero-length file for transfer, but it does not transfer the file's 
data. The generation of the listing file can be time-consuming 
because RESTOR copies ASCII data from the work file to the listing 
f. e ( w hich can be output on a terminal or written to disk). The 
listing file can grow quite large for a large system Restore 
operation. If the listing file consumes all free disk space, you can 
abort the RESTOR run. See the section "Interruption Commands" for a 
description of the ABORT command. Aborting the run while RESTOR is 
generating the listing file does not harm the Backup Set or the 
restored files in any way: it merely leaves you with an incomplete 
record of the Restore operation. 


Running RESTOR 

To run the RESTOR program, type: 

$ RUN RESTOR?:RESTOR 

RESTOR displays the RES[TORE], LOA[DINDEX], or LIS[T] question. If 
you want to operate in one of the three RESTOR modes from a DCL 
command file, type one of the following command's in response to the 
question (see the RSTS/E Guide to Writing Command Procedures). 
Substitute the name of the DCL command file for filename.type. For 
example: 

RES @filename.type 
LOA @filename.type 
LIS @filename.type 

The defaults for DCL command file names are RESTOR.CMD, LOADIN.CMD 
and LIST.CMD. 

To create a DCL command file, append the /SAVE (or /SA) option in 
response to the RES[TORE], LOA[DINDEX], or LIS[T] question. The 
following example shows the procedure and RESTOR's response: 

RES[TORE], LOA[DINDEX], or LIS[T]? RES/SAVE 
INDIRECT FILE NAME<SY:[ 1,213]RESTOR.CMD> ? 

In specifying a file other than the default, you can designate a disk 
or tape as the output device. After you answer the question, RESTOR 
continues to prompt normally, writes your responses into the DCL 
command file, and carries out the commands. 
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File Specification 

Several questions in the dialogue require you to respond with a file 
specification. The file specification lists criteria that files must 
meet for RESTOR to process them. The criteria can include file name, 
account, and dates of creation, and last access. In addition, you can 
specify one or more files as exceptions from a process. The file 
specification has the format: 

filename/keyword:comparison:date:time/exception (filename . . .) 

where: 


filename 

is a standard RSTS/E file specification of the format: 

[proj,prog]filename.type 

You can use the * and the ? wildcard characters in the 
PPN, file name, and file type fields. 

keyword 

is either CR[EATION] or AC[CESS] and specifies that 
RESTOR is to interpret the date and time as either 
file creation or access dates and times. 

comparison 

is either BEF(ORE] or AFT[ER] and specifies that 

RESTOR is to process files created or accessed before 
or after the date and time. 

date 

specifies the date RESTOR uses to process files. The 
format is: 

DD-MMM-YY 

where: 

DD specifies the day of the month. 

MMM specifies the first three month letters. 

YY specifies the last two digits of the year. 

time 

optionally specifies the time RESTOR uses to process 
files only when you specify CREATION. Use the 24-hour 
format such as 14:49. The default is 00:01. 

exception 

is EXC[EPT] and specifies that RESTOR does not process 
the specified files. You can include all of the 
previous elements in an EXCEPT phrase but do not 
include another EXCEPT phrase. Separate multiple file 
specifications with commas and enclose the list within 
parentheses. 
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Se pa rate creation and access date comparisons from each other and from 
the file name (even if it is null) by a slash (/). For example, a 
file specification applied to the default file name is: 

/CR:BEF:13 -JUN- 8 5 

The previous specification designates any files named by the default 
that were created before 13-JUN-85 (that is, 12-JUN-85 or earlier). 

A colon (:) separates the components of the specification. You can 
include only one CREATION comparison and one ACCESS comparison in each 
file specification. For example: 

*.BAC/AC:BEF:13 -JUN- 85/CR:BEF:09-APR- 85 

This specification designates all files with the file type .BAC (in 
the default account) that were last accessed before 13-JUN-85 and 
created before 09-APR-85. 

In addition to specifying a date, you can designate the time of day 
(m 24-hour format) in the CREATION comparison only. The following 
specification designates all files with name PLANTZ that have been 
created since 21:13 (9:13 PM) on 13-JUN-85: 

PLANTZ.*/CR:AFT: 13 -JUN -85:21:13 

You can exempt one or more files from a comparison or operation by 
including an /EXCEPT switch in the file specification. Follow these 
rules when using the /EXCEPT switch: 

o Any /EXCEPT: switch is associated with the file specification 
immediately preceding the slash (/). 

o You must enclose All /EXCEPT switch file specifications in a 
single set of parentheses (...). 

Note the following incorrect command line: 

[1.200] *.*,[1,210]*. */EXCEPT: [1,200]*.SY' 

Do not associate the /EXCEPT switch with the [1,210] file 
specification, but rather with the file specification for account 

[1,200]. Instead of placing the /EXCEPT:[ 1,200 ]*.SYS specification 
^t>-sr the specification for account [1,210], place it with the file 
specification, [1,200]*.* as follows: 

[1.200] *.*/EXCEPT:[1,200]*.SYS,[1,210]*.* 

This is the correct command line for the previous example. You now 
have the /EXCEPT switch immediately following the file specification 
you want it to define. 
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To include a CREATION or ACCESS comparison in an exception, you must 
enclose the files and any comparisons in parentheses as in the 
previous example: 


*.*/CR:BEF:13 -JUN- 8 5/EXC:(*.RNO/CR:AFT:16 - MAY-85,MT?.*/AC:AFT:0 9-APR-85) 

This command line specifies all files on the default account that were 
created before 13-JUN-85. The exceptions are: 

o All files with file type .RNO that were created after 
16-MAY-85 

o Any file whose name is three characters long, begins with MT, 
and has been accessed since 09-APR-85 

A CREATION or ACCESS comparison applies to the files in an EXCEPT 
comparison as well. To exclude an EXCEPT comparison from CREATION anc 
ACCESS comparisons, specify a CREATION or ACCESS date for the 
exception (and enclose the exception in parentheses). A file 
specification can include only one EXCEPT comparison. The EXCEPT 
comparison must follow any CREATION or ACCESS date comparisons. 

A list of file specifications often uses several lines. Use a hyphen 
(-) as the last character before the line ends; this indicates that 
the next line is a continuation of the current line. In response to 
the hyphen and line terminator, RESTOR prompts with CONT> and a tab. 
The specification must include all standard punctuation in addition to 
the hyphen. RESTOR performs no syntax or semantic processing on a 
response until you have entered all continuation lines. The following 
example shows the use of a continuation line, this time without the 
use of the /EXCEPT switch. (Note that the default is [1,213], which 
you are currently logged in to.) 

FROM FILES<[1,213]*.*>?BACK.RN0,CHAP3.RN0,TEST.BAS,- 
CONT>TAPE.BAS,[2,213]PRINT.BAC 

For example, the following command line designates all files on 
account [100,250] (except SOCIO.TMP) that were created after 
13-JUN-85: 

[100,250]*.*/CR:AFT:13 -JUN- 8 5/EXC:SOCI0.TMP 

RESTOR ignores spaces as separators in specification lines but 
considers them significant as terminators. For example, the following 
line is illegal because the space terminates the scan after the 
characters EXC: 

EXC EPT:BEE.BAS 
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On the other hand, in EXCEPT#:#BEE.BAS, RESTOR ignores the spaces and 
processes the text as: 

EXCEPT#:#BEE.BAS 

You can include a comment in a command line by beginning the comment 
with an exclamation mark (!), for example: 

FROM FILES<[1,213]*.*>? W:MANCH8.RNO!THIS FILE CONTAINS CHAPTER 8 

If you need to continue a command line and also include a comment, 
place the hyphen denoting a continuation line before the exclamation 
mark. For example: 

FROM FILES< [1,213]*.*>? CHAP2.RNO,BACK.CMD,TAPE.BAS-!THIS IS A COMMENT 
CONT> 


Running RESTOR Under OPSER-Based Batch Processing 

The OPSER-Based batch processor lets you perform a Restore operation 
without any dialogue interaction. This is possible if you create and 
execute a batch control file. In addition to BATCH control 
statements, the batch control file contains: 

O The RESTOR run command: RUN RESTOR?:RESTOR. 

o The responses to all dialogue questions, either as an 

explicit list within the file or as a list in the DCL command 
file specified in the first dialogue question response. See 
the section "Running RESTOR" for a discussion on the /SA[VE] 
option that creates the DCL command file. 

o The responses to all the mount dialogue questions. 

See Appendix A for a description of the OPSER-Based Batch Processor 
control statements. 

You must know the number of devices necessary for a RESTOR operation 
before submitting the batch job. If you do not know the exact number, 
it is better to include too many devices rather than too few. 
Furthermore, you must allocate a different drive for each device you 
specify. Make sure there are as many drives of the device type you 
are using as there are volumes in the Backup Set. 

You must include also a response for every mount question generated, 
such as the MOUNT IT ANYWAY? question that appears only if a RESTOR 
volume's expiration date has not passed, or if a magnetic tape cannot 
be read. The general rule is to anticipate all mount questions and 
include an appropriate response. 
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The RESTOR Dialogue 

The RESTOR dialogue lets you specify which files and accounts to 
restore, compare to their original versions, and delete. During the 
dialogue, RESTOR asks the same questions of all users. 

If you answer NO, RESTOR does not add any accounts to the destination 
disk. 

If you specify an account in the FROM FILE(S) <[CUR ACT] *.*> question 
and that account does not exist on the destination disk, RESTOR 
transfers the account only if you answer YES to the ENTER ACCOUNTS 
question. 

Tables 2-22 through 2-24 list the RESTOR questions and the responses 
the program requires. Table 2-22 list the RESTOR Dialogue Summary. 

Table 2-22: RESTOR Dialogue Summary 


+.+ 

| Question Response and Meaning I 

+.+ 

1 RES[TORE], LOA[DINDEX], or LIS[T]? 


RES[TORE] (/SA[VE]) 

Restores files. If you append /SA[VE], RESTOR 
creates an indirect command file and asks 
question la. 

la INDIRECT FILE NAME<_SY:[CUR ACT]RESTOR.CMD>? 

File specification 

Creates an indirect command file with the 
specified name. Valid output devices are disk 
and tape. Asked only if the SAVE switch is 
appended in question 1. 

2 WORK-FILE NAME<_SY:[CUR ACT] Bddmmm.Jnn>? 

File specification 
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Table 2-22 (cont.) 


+.+ 

| Question Response and Meaning | 

+.+ 


| Uses the specified file as the work file. If the 

| default is accepted, RESTOR uses either Bddmmm 

| or Bymmdd as the file name format. If the system 

| date format, selected during system 

j installation, is alphabetic, the default name 

j format is Bddmmm. 

| where: 

| dd specifies the day of the month 

| mmm specifies the first three characters of 

I the month 

| If the system date format is numeric, Bymmdd is 

j the default name format. 

| where: 

I 

I 

| y specifies the last digit of the current 

I year 

j mm specifies the number of the month 

j dd specifies the day of the month 

j In the .Jnn file type, nn represents the job 

j number RESTOR is running under. You can 

j substitute any mounted, write-enabled disk for 

| SY:. 

| 3 LISTING FILE<_KB:>? 

j KBn: or LPn: 

| Writes the listing file to the specified 

j keyboard or line printer unit. 

j File specification 

j Writes the listing file to the specified file on 

j disk or tape. The default file name is SY: [CUR 

ACT] RESTOR.LST. 
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Table 2-22 (cont.) 


+.+ 

| Question Response and Meaning | 

+.+ 

I I 

I 4 INDEX FILE<PRIMARY> ? I 


File specification 

Uses the specified file as the index file. You 
can specify an auxiliary index file or an index 
file created during a Loadindex operation. If 
you accept the default, RESTOR uses the primary 
index file that is on the final volume of the 
Backup Set. 

5 FROM DEVICE <_MT:> ? 

MT:, MM:, MS:, or disk name 

Restores backed-up files from the specified 
medium. (Do not specify a unit number here, only 
a device type. RESTOR requests the unit number 
later.) 


6 


7 


FROM FILE(S) <[CUR ACT]*.*>? 

BACKUP File specification(s) 

Restores the specified files. 

TO DISK<_SY:[*,*]>? 

Disk name 

Restores the specified files to the designated 
disk. 


8 BEGIN. AT< [*,*]*.*>? 

BACKUP File specification 

Restores starting with the file specified here. 
The default starts with the first file matching 
the file specification in question 6. The answer 
must be a single file specification. No EXCEPT 
modifiers are allowed. 

9 ENTER ACCOUNTS<YES> ? 

YES 

Creates, on the destination disk, all accounts 
on the Backup Set that do not already exist on 
the destination disk 


Does not create any accounts. You cannot 
selectively create accounts. 
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Table 2-22 (cont.) 


+.- . - . -.+ 

| Question Response and Meaning I 

... 

I I 

I 10 SUPERSEDE<NONE> ? I 


BACKUP File specification(s) 

Overwrites the specified files on the 
destination disk with the backup versions. If 
you accept the default, RESTOR does not 
supersede any files. (To supersede files, you 
must include a file specification. RESTOR does 
not supersede all files on the destination 
volume if you type ALL or YES. Instead of 
superseding the entire volume, RESTOR replaces 
only files that have a file specification of ALL 
or YES.) 

11 COMPARE FILE(S)<NONE>? 

BACKUP File specification(s) 

Compares the restored files to the backup 
versions after transfer. As in the SUPERSEDE 
question, you must provide a file specification 
here instead of an answer such as ALL or YES. 
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Table 2-23 lists the LOADINDEX Dialogue Summary. 
Table 2-23: LOADINDEX Dialogue Summary 


| Question Response and Meaning I 

...+ 

I 

1 RES[TORE], LOA[DINDEX], or LIS[T]? I 


LOA[DINDEX]? 

Copies index file from the Backup Set to a 
RSTS/E formatted disk. If you attach /SA[VE] to 
the LOA[DINDEX] response, RESTOR creates an 
indirect command file and asks question la. 

la INDIRECT FILE NAME <_SY:[CUR ACT]LOADIN.CMD>? 

File specification 

Creates an indirect command file with the 
specified name. Valid output devices are disk 
and tape. This question is asked only if you use 
the /SA[VE] switch in response to question 1. 

2 WORK-FILE NAME<_SY:[CUR ACT]Bddmmm.Jnn>? 

File specification 

Uses the specified file as the work file. If you 
accept the default, LOADINDEX uses either Bddmmm 
or Bymmdd as the file name format. 

where: 

dd specifies the day of the month 

mmm specifies the first three characters of 
the month 

y specifies the last digit of the year 

mm specifies the number of the month 

In the file type .Jnn, represents the job number 
RESTOR is running under. You can substitute any 
mounted, write-enabled disk for SY:. 

3 LISTING FILE<_KB:>? 

KB: or LP: 

Writes the listing file to the keyboard or the 
line printer. If you press RETURN or LINE FEED, 
RESTOR sends the listing file to the keyboard 
<KB:>. 
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Table 2-23 (cont.) 


I Question 


Response and Meaning 


+ 


File specification 


Writes the listing file to the specified disk or 
tape. If you type SY: and then press RETURN, the 
RESTOR program creates the default listing file 
[CUR ACT]LOADIN.LST. 


4 


FROM DEVICE< MT:>? 


MT:, MM:, MS:, or Disk Name 

Copies the index file from the specified Backup 
Set device. 

TO FILE<_SY:[CUR ACT] [BINDdd.IND]? 

File specification 

Loads the Backup Set index file into the 
specified file. You can copy the index to a disk 
device only. The format for the default file 
name is BINDdd.IND, where dd is the numeric day 
of the month. 
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Table 2-24 

lists the LIST Dialogue Summary. 

Table 2-24: 

LIST Dialogue Summary 

+. 

| Question 
+ - - -. 

Response and Meaning | 

1 

1 

| 1 

1 

1 

1 

1 

1 

1 

RES[TORE], LOA[DINDEX], or LIS[T]? I 

LIS[T]/SA[VE] 1 

Runs the LIST dialogue. When you attach the | 

/SA[VE] switch to the LIST response, RESTOR | 

creates a DCL command file after you respond to | 
question la. 1 

1 

1 

1 la 

1 

1 

1 

1 

1 

1 

INDIRECT FILE NAME<_SY:[CUR ACT][LIST .CMD]>? | 

File specification I 

Creates a DCL command file with the specified | 

name. Question la appears only if you use the ! 

/SA[VE] switch in response to question 1. Valid | 
output devices are disk and tape. | 

1 

1 

1 2 

! 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

WORK-FILE NAME<_SY:[CUR ACT]Bddmmm.Jnn>? i 

File specification 1 

Uses the specified file as the work file. If you | 
accept the default by pressing RETURN or LINE j 

FEED, LIST uses either Bddmmm or Bymmdd as the | 

file name format. I 

1 

where: 1 

1 

dd specifies the day of the month | 

1 

mmm specifies the first three letters of | 

the month I 

mm specifies the number of the month | 

In the file type .Jnn, nn represents the job | 

number RESTOR is running under. You can j 

substitute any mounted, write-enabled disk for | 

SY: . | 

i 

! 

| 3 

1 

1 

1 

1 

1 

1 

LISTING FILE<_KB:>? | 

KB: or LP: | 

Writes the backup directory information to the | 

specified device. If you press RETURN or LINE | 

FEED, the backup directory is written to your | 

keyboard. Type LP: and press RETURN for a line j 

printer listing. I 
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Table 2-24 (cont.) 


. .. 

| Question Response and Meaning | 

... '- + 


File specification 

I Writes the backup directory information to the 

specified file. Type SY:, and press RETURN if 
you want RESTOR to create the default listing 
I file, [CUR ACT]LIST.LST. | 

4 INDEX FILE<PRIMARY>? 

I File specification 

Extracts the index file from the specified file 
and writes it to the listing file. If you accept | 
the default by pressing RETURN or LINE FEED, 

LIST requests the index volume. It then takes 
the directory information from the index volume 
I and writes the information to the listing file. 

The program asks the next question, FROM 
DEVICE<_MT:>, if you accept the default in | 

*1 question 4. 

I 

| 5 FROM DEVICE <_MT:> ? 

| File specification 

I Asked only if you accept the default in the 

I INDEX FILE<PRIMARY> question. The file 

specification response must identify the device 
I on which the index resides. You can accept the 

I magnetic tape default <_MT:> by pressing RETURN | 

I or LINE FEED. The LIST program begins a MOUNT 

I dialogue, which asks you to mount the Backup Set | 

| index volume and identify the target device. 

... 


Interruption Commands 

The RESTOR package includes interruption commands for your 
convenience. These commands enable you to detach, terminate, suspend, 
and continue processing, and to check the status of the run. 

RESTOR shows it is ready to accept interruption commands by printing 
an * character on the job's console terminal after the dialogue is 
complete. You can type an interruption command as a response to a 
request in the MOUNT dialogue or any time after the * character 
appears. 
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Table 2-25 lists the RESTOR interruption commands and 
Table 2-25: RESTOR Interruption Commands 


their meanings 


... 

| Command and Meaning | 

... 


ABO[RT] 

Terminates processing immediately and returns control to 
your keyboard monitor. 


CON[TINUE] 

Continues processing after a PAUSE command. 


DET[ACH] 

Detaches job from KB:, 
are met: 


RESTOR detaches if three 


conditions 


o OPSER is running, 
o The listing file is not on KB: 


No messages are currently pending for this copy of 
RESTOR. 


RESTOR is given a receiver identification of BACKnn, where 
nn is its job number. All interaction with RESTOR is done 
through OPSER. 


END 


Terminates after processing the current file. 


LAS[T] 


Reprints, on KB:, the last text printed. If the program is 
awaiting a response, reprints the question or prompt. If 
not, reprints the last message. 


LEG[AL] 

Prints, on KB:, a list of the commands and responses that 
are legal now. In the list, **OTHER** means that a request 
for information from you is pending, for instance. Backup 
Set name. The response to such a request is any appropriate 
string. You do not need to use quotation marks (")unless the 
response can be construed as an interruption command. For 
example, you can legally name the Backup Set PAUSE, but you 
must type the name in quotes ("PAUSE") 


! 
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Table 2*25: RESTOR Interruption Commands (Cont. 


Command and Meaning 


NOT[ICE] 

Writes the specified text in the listing file. The NOTICE 
command has the format: 

NOT[ICE] message 

Message represents one line of text. No line terminators are 
allowed in the message. 

OFF[LINE] 

Same function as ABORT. 

PAU[ S E ] 

Suspends execution until you type CONTINUE. Any legal 
command typed during a PAUSE is executed immediately. 

STA[TUS] 

Prints, on KB:, RESTOR status information. 

TER[MINATE] 

Closes the current volume at the end of the current file or 
at the end of the current output volume, whichever comes 
first. 


Mounting and Dismounting Volumes 

After RESTOR selects all files and accounts for transfer, it requests 
Backup Set labeling information and the device unit number for the 
first backup volume. It also prints a volume identification summary. 

The labeling information is the name and expiration date of the Backup 
Set. The name identifies the Backup Set. RESTOR interprets the 
expiration date as the date after which it can automatically write 
over the data on the volume. The default expiration date is one year 
from the current date. If you mount a volume for backup before its 
expiration date, RESTOR asks for confirmation before writing on the 
volume. RESTOR requests density and parity for 800 bpi magnetic 
tapes, and density for 1600 bpi tapes. 
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After answering the labeling questions, mount the volume and 
write-lock it for a Restore operation. In response to the DEVICE 
question, type the full mounted volume device specification (device 
mnemonic and unit number followed by a colon); for example, MMl:. 

Note 

You must keep the disks that RESTOR uses write - enabled 
because bad block files on disk must be updated as 
required. 

RESTOR executes the interruption commands and the 
RET[RY], SKI[P], and IGN[ORE] requests during the 
MOUNT dialogue if responses to any question has as its 
first three characters the first three characters of a 
command or request. To avoid this, enclose the 
response in quotation marks (" ")/ or make sure the 
response does not contain the same first three 
characters as the commands and requests. 


The following example shows the mount procedure printout. Press LINE 
FEED to select a default response: 


PLEASE ENTER BACKUP SET NAME<BACK28> -- <LF> 
PLEASE ENTER DENSITY IN BPI<800> -- 800 <RET> 
PLEASE ENTER THE PARITY<ODD> -- <LF> 

MOUNT DEVICE: _MM: 

ID: 

SEQ#: 

DENSITY: 

PARITY: 


BACK28 

1 

800 BPI 
ODD 


DEVICE? MMl: 

THIS VOLUME HAS NO BACKUP LABEL! 
MOUNT IT ANYWAY<NO>? Y 


RESTOR attempts to read the mounted tape at all valid density and 
parity settings.to determine whether there is a backup label on the 
tape. 


When RESTOR finishes with a volume, the program prints a dismount 
message. For example: 


DISMOUNT DEVICE: 


MMl: 

ID: 

SEQ#: 

DENSITY: 

PARITY: 


BACK28 

1 

800 BPI 
ODD 
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When the dismount message appears, physically dismount the volume and 
prepare the next volume for processing. RESTOR requests name, 
expiration date, parity, and density for only the first volume in each 
Backup Set. Use the information in the dismount message to label the 
tape. For later volumes, RESTOR requires only the device 
specification. 


Note 

RESTOR logically mounts disks you use during any of 
its operations. Do not attempt to mount or dismount 
them logically using the DCL MOUNT or DISMOUNT 
commands. DCL expects a RSTS/E file - structured disk. 

A RESTOR volume has its own structure and causes the 
system to generate an error when it tries to logically 
mount or dismount a RESTOR volume. 


RESTOR Error Handling 

Four types of errors are possible with RESTOR: 

o Dialogue command errors that occur during the Restore, 

Loadindex, or List dialogue. RESTOR diagnoses these errors 
immediately. Usually, you can respond to these errors by 
typing the correct dialogue answer. 

o Interruption command errors that occur when you type an 

interruption command. RESTOR responds immediately to these 
errors, also. Type a valid command. 

o Volume mount errors that occur when RESTOR mounts tape and 
disk backup volumes. Some volume mount errors are user 
errors (for example, specifying an illegal density setting 
for tape); others involve hardware (for example, tape errors 
that prevent labeling). 

o Processing errors that occur any time during the BACKUP run 
except during the dialogue. The hardware on which BACKUP is 
running or logic errors can cause processing errors. 

The following sections describe each of these four error types. 


Dialogue Command Errors 

When RESTOR finds a dialogue command error (usually a syntax error), 
the program prints the error message PCommand error on your terminal. 
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The error message is followed by ither a RESTOR-specific error 
message or a RSTS/E error message generated during the syntax 
processing of the command. After printing the error message, RESTOR 
prints a question mark (?) and repeats its prompt. If you type a 
question mark (?) and press RETURN, RESTOR prints the command line up 
to the position of the error, and then prints the prompt again. 

Table 2-26 lists the RESTOR dialogue error messages and their 
meanings. 

Table 2-26: RESTOR Dialogue Error Messages 


| Message and Meaning | 

+ . + 

| ?BAD DIRECTORY FOR DEVICE 

| The directory structure on the device you specified is j 

j corrupt. Try to place the file on a different device. 

I I 

| ?CAN'T FIND FILE OR ACCOUNT | 

j RESTOR cannot find the file or account you specified. Make j 

| sure you typed the file name and account correctly and' that j 

j they exist. j 

I ' I 

| ?DEVICE HUNG OR WRITE-LOCKED j 

j The device you specified is hung or write-locked or has j 

| generated a read or write error. Make sure the device is j 

| ready, write-enable the device (if necessary), or specify a j 

j different device. j 

I I 

| ?DEVICE NOT AVAILABLE | 

| The device you specified is disabled or assigned to another j 

j user. Specify a different device. 

I I 

| ?DUPLICATE SWITCH | 

The file specification contains multiple ACCESS or CREATION | 

| comparisons. RESTOR accepts only one of each comparison in a | 

j file specification. 

I I 

| ?ILLEGAL EXCEPT NESTING | 

j The file specification includes more than one EXCEPT 

| comparison. RESTOR accepts only one EXCEPT in a file 

| specification. | 

I I 

| ?ILLEGAL FIELD j 

| The response contains a field that is not permitted. For 

example, you cannot specify a device name in the response to | 
j the FROM FILES question. 
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Table 2*26: RESTOR Dialogue Error Messages (Cont.) 


Message and Meaning 


?ILLEGAL FILENAME 

The file name you specified contains invalid characters or 
has an incorrect format. 

?ILLEGAL KEYWORD 

The response contains a misspelled or incorrectly 
abbreviated keyword or has incorrect punctuation marks. 

?ILLEGAL OPERAND 

The EXCEPT comparison in the file specification contains an 
unmatched parenthesis, or the day or year number in a date 
is out of range. 

2INC0MPLETE COMMAND FILE 

You entered CTRL/Z or the DCL command file ended before the 
expected end-of-file (EOF). RESTOR returns to the RES[TORE], 
LOA[DINDEX], or LIS[T] question. 

?N0 DEFAULT 

The current dialogue question does not have a default 
answer. You must type an explicit response. 

?NOT A VALID DEVICE 

The device you specified is not on this system. 

?NOT A VALID DEVICE (PROHIBITED) 

The device you specified in response to this question is 
illegal. 

7PR0TECTI0N VIOLATION 

The file or account you specified is protected. 

?TOO MANY FILES OPEN ON UNIT 

Only one file at a time can be open on a magnetic tape unit. 
Specify the second file on another device. 

?TOO MUCH DATA 

The response contains more data than RESTOR accepts for this 
question. 

?UNIT NUMBER NOT VALID 

RESTOR does not accept a device unit number in the response 
to this question. * 
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Interruption Command Errors 


An invalid interruption command generates one of three 

Table 2-27 lists the RESTOR interruption command error 
their meanings. 


error messages, 
messages and 


Table 2-27: RESTOR Interruption Command Error Messages 


Message and Meaning 


?CAN'T DETACH 

The DETACH command is invalid because one or more of the 
three DETACH conditions described in Table 2-25 is not true. 

7UNRECOGNIZED COMMAND 


You typed a string that is not an interruption command. 


?ILLEGAL COMMAND 

You typed an interruption command that is illegal (for 
example, typing CONT when no PAUSE is in effect). Type LEGAL 
for a list of interruption commands that are currently 
legal. 


+ 

! 


Volume Mount Errors 


Several errors can occur during the volume mount procedure. RESTOR 
prints an error message and then repeats the current prompt. 

Table 2-28 lists the RESTOR volume mount error messages and their 
meanings. 

Table 2*28: RESTOR Volume Mount Error Messages 


Message and Meaning 


7DENSITY/PARITY CANNOT BE SET ON THIS DRIVE 

Specified parity or density is illegal on this type of 
hardware. 


?INVALID BACKUP SET NAME 

The set name contains illegal characters. 

?INVALID DATE 
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Table 2*28: RESTOR Volume Mount Error Messages (Cont.) 


+.+ 

| Message and Meaning | 

+.- - - + 

| Date is not in dd-mmm-yy format or has passed. | 

I I 

| ’INVALID DENSITY SETTING | 

j Valid density settings are 800 and 1600 bpi. 


?INVALID DEVICE OR NO UNIT NUMBER 

The input device specification refers to a device not 
configured on the current system, or the device unit number 
is not specified. 


?INVALID PARITY SETTING 

Valid parity settings are ODD and EVEN. 


’INVALID SWITCH SPECIFICATION 

The switch does not contain (as its first three characters) 
SCR. 

?MAGTAPE NOT WRITE LOCKED 

During a RESTORE operation, the magnetic tape must be 
mounted write-locked. 


’MAGTAPE SELECT ERROR 

The magnetic tape unit specified is not READY or is OFFLINE. 


Ready the unit or specify 

’MAGTAPE WRITE LOCKED 

During a backup operation 
write-enabled. 

7THIS IS NOT THE RIGHT VOLUME 

Some volume data does not 


another unit. 

the magnetic tape must be mounted 


match with what RESTOR expected. 


| ?UNABLE TO WRITE ON THIS TAPE | 

j RESTOR cannot write a label on the magnetic tape because of j 

j tape errors. Try another magnetic tape. | 

| ?YOU ARE NOT PRIVILEGED TO USE THIS VOLUME 

j The volume's expiration date has not yet passed, and the j 

user has insufficient privilege (and is not the volume's j 

j owner). | 

+.+ 
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RESTOR Processing Errors 

Errors can occur as the package selects, transfers, compares and 
deletes files and generates the listing file. An error can be a 
hardware error (for example, ?Device hung or write-locked), or a logic 
error action (for example, ?Protection violation). 

If a logic error occurs during the selection process, RESTOR skips 
over the file or account causing the error. RESTOR prints an error 
message and then selects the next file or account according to the 
following rules: 

o If an error occurs while RESTOR is looking up a file, RESTOR 
skips that file in that account and looks for the next file. 

o If an error occurs during the search for an account (except 
for the final input volume), RESTOR terminates the search on 
that input volume and continues the search for that account 
on the next input volume. 

o If an error occurs during the search for an account on the 
final input volume, RESTOR returns to the first input volume 
and searches for the next sequential account. 

o If an error occurs in the final account on the final input 
volume, the selection process ends and RESTOR begins to 
transfer the selected files and accounts. 

RESTOR contains error handling routines that allow you to correct or 
avoid problems that cause the ?Device hung or write-locked hardware 
error. When this error occurs, RESTOR prints the error message, 
followed by one or more valid request commands (RETRY or SKIP) in 
parentheses. After RESTOR issues an * prompt, you can respond with 
one of the suggested commands. A RETRY response causes RESTOR to 
attempt the failed operation again. For example, device hung errors 
may indicate: 

o A transient hardware problem 

o A device has gone off line 

o A file or account contains bad blocks 

You may be able to correct a transient hardware problem by using the 
RETRY command. When a device goes off line you can usually place the 
device back on line and respond to the * prompt by typing RETRY. 
Finally, if bad blocks in a file or account cause a device hung error, 
you can attempt to bypass the bad block area by using the SKIP 
command. In reply, RESTOR ends its search of the file or account 
containing the bad block, proceeds to look for the the next file or 
account, and then attempts to resume normal processing. 
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During a Restore operation, a bad block error at index load time 
usually means that the index file is corrupt. If you specified that 
RESTOR use the primary index file, RESTOR displays the following error 
message: 

?Primary index load failed! Starting secondary load 

RESTOR attempts to load the secondary index file (which may require 
you to mount a different volume). 

If an error occurs during the secondary index load, RESTOR prints the 
following error message and aborts: 

?Secondary index load failed. Run aborted!!! 

You must rerun RESTOR, using the auxiliary index file. 

If you specified the auxiliary index file and a load error occurs, 
RESTOR prints the following error message and aborts: 

?Auxiliary index load failed -- filename'. type due to <text> error. 
Run aborted!!! 

The <text> is the RSTS/E error that caused the load failure. 

The bad block error message ?Data error on device that occurs during 
the Restore operation is fatal. RESTOR prints the following error 
message and aborts the run: 

?Unexpected error -- data error on device 

Logic errors during the transfer, deletion, and listing processes 
usually result from failure to open a file that RESTOR must transfer 
or delete. For example, the error message ?Protection violation means 
the file protection code prohibits you from deleting or transferring a 
certain file. Another error message , ?Supersede failure, indicates a 
failure to restore a file that already exists on the destination disk. 
This error can occur even if you did not request a supersede 
operation. The RESTOR package automatically skips over the file or 
account causing a logic error during transfer, deletion, or listing 
processes. 

RESTOR error handling routines allow you to retry (RETRY) or skip 
(SKIP) over an error that occurs during the transfer, deletion, or 
listing process. The associated error message is ?Device hung or 
write-locked. RETRY and SKIP work in the same way here as they do 
during the selection process. 

In addition to device hung errors, other errors can interrupt RESTOR, 
displaying error messages such as ?Can't find file or account or ?No 
room for user on device. If RESTOR displays one of these error 
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messages while processing a listing file, type the IGNORE request 
command in response to the * prompt. This procedure forces RESTOR to 
disable future I/O to the listing file and to continue with the 
current operation. 

The sequencing problem on magtape error can occur when restoring from 
magnetic tape. This error means that RESTOR read a magnetic tape that 
did not have the expected record number. When the sequencing error 
occurs, RESTOR usually prints several bad block error messages (as it 
tries and fails to space to the correct magnetic tape record) and then 
recovers automatically. You cannot restore the file in which the 
sequencing error occurred; however, you can restore the remainder of 
the files on the tape. 

If RESTOR finds a bad block during a transfer operation that involves 
a RSTS/E (not a RESTOR) disk, RESTOR prints an error message. It 
copies the rest of the current file although the file is corrupt. If 
the bad block is in the work file, RESTOR aborts. 

When RESTOR discovers a bad block on a backup disk, it allocates the 
bad block to the bad block file. This procedure prevents future use 
of the block for backup data. (You should be aware that RESTOR bad 
block files are not equivalent to the RSTS/E file BADB.SYS. You must 
reinitialize a backup disk before using it as a RSTS/E file-'Structured 
disk. ) 

During the transfer process, RESTOR often prints informational 
messages. These messages usually do not indicate errors, but inform 
you about files that are open (and subject to change) and files that 
have changed in length since selection. RESTOR transfers these files, 
but the copies may not be accurate. Other messages list files that 
RESTOR cannot transfer: those deleted since selection and those whose 
length is zero. 

The RESTOR program displays a timed reminder after you type the PAUSE 
command and when it is waiting for a user response. Two minutes after 
you type the PAUSE command, which suspends the execution of a Restore 
operation, RESTOR prints the message IN PAUSE. The reminder appears 
only once. Similarly, RESTOR reminds you, after a two minute 
interval, that it is waiting for a user response. The error message 
?Further response necessary does not appear during any of the initial 
dialogue questions. Like the PAUSE reminder, note that RESTOR does 
not repeat this message. 


Restore File Example 

RESTOR recreates a RSTS/E formatted disk from a magnetic tape or disk 
Backup Set. The example in the following section shows how to restore 
an RK06 disk from a magnetic tape Backup Set. The section " Restore 
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Listing File" reproduces and describes the listing file that results 
from the Restore run in the following section. 


Restore Terminal Printout 

To duplicate the following example, run the RESTOR program, and 
respond to the dialogue questions as shown. The letters in the 
printout are keyed to the description that follows: 

$ RUN RESTORS:RESTOR 
RESTOR V9.0 RSTS V9.0 

a RES[TORE], LOA[DINDEX] OR LIS[T] ? RES 

b WORK FILE NAME <_SY:[ 1,110]B08SEP.J16> ? RESTOR.WKF 

C LISTING FILE <_KB :> ? RESTOR.LST 

d INDEX FILE<PRIMARY> ? <LF> 

e FROM DEVICE<_MM:> ? MM: <RET> 

f FROM FILES<[ 1,110]*.*> ? [2,110]BACKUP.BAS,BACKTO.BAS 

g TO DISK<_SY:[*,*]> ? DM1: 
h BEGIN AT<[*,*]*.*> ? <RET> 
i ENTER ACCOUNTS<YES> ? NO 


j SUPERSEDE FILES<NONE> ? <LF> 


k 

COMPARE 

FILE<NONE> ? 

<RET> 

1 

* <RET> 



m 

PLEASE 

ENTER BACKUP 

SET NAME<RESTOR> - BACKUP 


PLEASE 

ENTER DENSITY 

IN BPI<800> - <LF> 


PLEASE 

ENTER THE PARITY<ODD> - <LF> 


MOUNT 

DEVICE: 

_MM : 



ID: 

BACKUP 



SEQ#: 

INDEX 



DENSITY: 

800 BPI 



PARITY: 

ODD 

n 


PLEASE MOUNT 

VOLUME WRITE LOCKED! 

0 

DEVICE? 

MMl: 
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*STATUS 


PHASE : SELECT 
VOLUME # : 2 
ERRORS : 0 

CURRENT VOLUME 
CURRENT ACCOUNT : 


ELAPSED TIME 
CPU TIME 
KCTS 


MM 

‘dmi 


S[2,110] 


1 SECONDS 
.4 SECONDS 
64 


q DISMOUNT DEVICE: 
MOUNT DEVICE: 

ID: 

SEQ#: 

DENSITY: 

PARITY: 


_MM1 

_MM 

BACKUP 

1 

800 BPI 
ODD 


r PLEASE MOUNT VOLUME WRITE LOCKED 1 

S DEVICE? MMO: 


t DISMOUNT DEVICE: 
★ 

$ 


MMO 


The explanation of the Restore example follows: 


Line Description 

a Type RES in response to the initial RESTOR prompt, and then 

press RETURN. This starts the RESTOR program, which 
prints a set of dialogue questions. 

b Specify a work file name that does not have a .TMP file type 

such as RESTOR.WKF. RESTOR deletes any work file created 
during a Restore operation that has a temporary file type of 
.TMP. 

c Create the RESTOR.LST file to store the listing file generated 

from this Restore operation. RESTOR prints the listing file at 
your terminal (KB:) if you accept the default. 

d Press LINE FEED to have RESTOR transfer the primary index file, 

located on the last volume of the Backup Set, to the 
destination disk. 
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Line Description 

e Type the magnetic tape device type MM:, MS:, or MT:. 

f Specify the files for RESTOR to recreate on the output disk. 

In this case, RESTOR returns the two files [2,110]BACKUP.BAS 
and BACKTO.BAS to the RK06 disk. 

g Identify the disk to which you plan to copy the files contained 

on the magnetic tape Backup Set. Type DM1:, which is the device 
specification of the RK06 disk. 

h Have RESTOR begin processing the first file it finds on 

the Backup Set by pressing RETURN to accept the default. 

i Type NO to make sure the files that exist on the Backup Set but 

do not exist on the output disk are not reproduced. 

j Press LINE FEED to have files superseded. That is, you do not 

want any files on the Backup Set to overwrite the same files on 
the output disk. 

k Accept the default; you do not want any files compared. 

1 RESTOR prints an * prompt after you complete the 

dialogue. This indicates the program is ready to accept 
interruption commands. Ignore the prompt at this point; you 
have no reason to interrupt processing. 

m Type the correct name of the Backup Set. (Whatever name you 

enter in response to the WORK FILE NAME question, RESTOR 
uses for the default response to PLEASE ENTER BACKUP SET NAME.) 
After you press LINE FEED in response to the next two 
questions, RESTOR prints a summary of the label information 
contained on the Backup Set. 

n The message asks you to mount the last volume of the Backup 

Set, the one containing the primary index file. Mount it 
without the write-enable ring. If you have not created an index 
file with Loadindex, created an auxiliary index file by copying 
the work file using PIP.SAV, or have not given the work file a 
file type other than .TMP during the Backup operation, you 
must repeatedly load the last backup volume for each Restore 
operation. Use Loadindex to create an easily accessible index 
and eliminate this inconvenience. 

o Enter the device specification of the last volume of the 

Backup Set. RESTOR needs the index that is on the last volume 
to begin the Restore operation. (Note that SEQ #: tells you 
which volume you should load; the index volume MMl: is the 
correct volume to load in this case.) 
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Line 

p Respond to the * prompt by typing STATUS, which 

summarizes the operational status of the Restore run. The 
summary indicates that RESTOR: 

o Is in the select PHASE 

o Is processing the last volume of the Backup Set 
o Has found no errors 

o Is performed from a magnetic tape Backup Set 
o Is processing account [2,110] 

o Has consumed 1 second of elapsed time, 0.4 seconds of 
CPU time, and 64 kilo - core - ticks 

After printing the summary, RESTOR returns to normal processing, as 
the * prompt indicates. 

q The dismount summary that RESTOR prints when it finishes 

processing the Backup Set volume that contains the primary 
index file. 

r RESTOR asks you to mount the remaining Backup volume. 

s Type the device specification of the device on which you 

have mounted the second volume of the Backup Set. After you 
press RETURN, RESTOR selects the specified files from the 
mounted volume and transfers them to the output disk. 

t After RESTOR prints the dismount message for the second 

volume, it prints the * prompt. 


Restore Listing File 

The listing file summarizes the phases of the Restore operation and 
provides directory information on the restored files. The letters in 
the example are keyed to the description that follows: 

Restore Run Listing 

a Restore from '_MM :' to '_DM :[*,*] 

Run started on 13-Jun-85 at 11:57 AM 
Work-File is SY :[ 1,110 ]RESTOR.WKF/MO: 256 
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Transfer 

[2,110]BACKUP.BAS,[2,110]BACKTO.BAS 

Begin at : 

[*,*]*.* 

Superseded : 

<none> 

Compare : 

<none> 


b PHASE : LIST COMPLETE 
ERRORS : 0 


ELAPSED TIME 
CPU TIME 

KCTS 

: 1 SECONDS 
: .5 SECONDS 

: 72 


C PHASE : MOUNT / DISMOUNT COMPLETE 


ERRORS :0 


ELAPSED TIME 
CPU TIME 

KCTS 

: 61 SECONDS 
: .9 SECONDS 
; 160 


PHASE : INDEX LOAD COMPLETE 
ERRORS : 0 

CURRENT VOLUME : MMl : 


ELAPSED TIME 
CPU TIME 

KCTS 

: 1 SECONDS 
: .7 SECONDS 

: 107 


e PHASE : SELECT COMPLETE 
VOLUME # : 2 
ERRORS : 0 


ELAPSED TIME 
CPU TIME 

KCTS 

: 2 SECONDS 
: .8 SECONDS 

: 128 


f PHASE : MOUNT / DISMOUNT COMPLETE 


ERRORS : 0 


ELAPSED TIME 
CPU TIME 

KCTS 

: 24 SECONDS 
: .8 SECONDS 
: 144 


g PHASE : TRANSFER COMPLETE 
VOLUME # : 1 

ACCOUNTS : 1 
FILES : 2 
BLOCKS : 289 
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ERRORS : 0 

CURRENT VOLUME : _MM0 : 
CURRENT FILE : _MM0 : 

ELAPSED TIME : 50 SECONDS 
CPU TIME : 1.5 SECONDS 

KCTS : 254 


h PHASE : MOUNT / DISMOUNT COMPLETE 
ERRORS : 0 

ELAPSED TIME : 15 SECONDS 
CPU TIME : .2 SECONDS 

KCTS : 32 

i Backup Set Name : BACKUP 
Volume Sequence # .: 1 
Creation Date : 13-Jun-85 
Density : 800 BPI 

j Account : [2,110] 

Clustersize : 4 

Creation Access 

Name Ext Size Prot Date Time Date Clu RTS TSCD 

BACKUP.BAS 121 42 Ol-Jun-85 09:56 AM 01-Jun-85 8 BASIC T 

BACKTO.BAS 168 42 Ol-Jun-85 04:36 PM 01-Jun-85 8 BASIC T 

k Account total of 289 blocks in 2 files on account [2,110] 

1 ***** Account continued on next Volume ***** 


Backup Device : _MM 
Owner : [1,110] 

Expiration Date : 13-Jun-85 
Parity : ODD 

Quota : 0 


m Volume total of 289 blocks in 2 files in 1 accounts on volume MM 


n Backup Set Name : BACKUP 

Volume Sequence # : 2(Index) 
n Creation Date : 13-Jun-85 
Density : 800 BPI 

O <NO TRANSFER SELECTED> 


Backup Device : _MM 
Owner : [1,110] 

Expiration Date : 13-Jun-85 
Parity : ODD 


p Volume total of 0 blocks in 0 files in 0 accounts on volume _MM 


q RUN total of 289 blocks in 2 files on 0 accounts on 2 Volumes 
RUN total of 0 errors 


r PHASE : LIST COMPLETE 
VOLUME # : 1 
ERRORS : 0 
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The 

Line 

a 



b 


c 


d 



e 

f 


9 



h 

i 


j 



k 


ELAPSED TIME : 3 SECONDS 
CPU TIME : 1.1 SECONDS 

KCTS : 162 

explanation of the Restore listing file follows: 

Description 

Summarizes the RESTOR dialogue that indicates you are 
restoring two files in account [2,110], BACKUP.BAS and 
BACKTO.BAS. The summary also shows that RESTOR starts 
processing at the beginning of the file, does not supersede 
any files, and does not compare any files. 

Supplies accounting statistics about writing the dialogue 
summary into the listing file. 

Summarizes the mount/dismount phase, during which you mounted 
the backup index volume. 

Describes the loadindex phase. 

Summarizes the selection phase statistics. 

Indicates that RESTOR finished selecting data from the backup 
index volume and requested that it be dismounted. The summary 
also describes the various times required to complete the 
dismount operation and mount the other volume in the Backup 
Set. 

Describes the transfer phase which shows that two files 
selected for transfer were on volume 1. 

Displays the mount/dismount summary, which is caused by the 
dismount request that occurs at the end of the transfer. 

Lists the label information for volume 1 after displaying each 
operational phase. 

Prints the directory information for each file and account for 
that volume. This section includes the account, quota, and 
cluster size for each affected account and lists each restored 
file by name. The block size-, protection code, date and time of 
creation, date of last access, cluster size, and associated 
run-time system are listed for each file. The TSCD column 
contains a T for each restored file because you specified only 
that they only be transferred, not superseded (S), compared 
(C), or deleted (D). 

Indicates that a total of 289 blocks in 2 files were 
transferred for account [2,110]. 
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Line Description 

1 States that account [2,110] is continued on the second volume. 

m Displays the block, file, and account summary for the entire 
volume. 

n Lists label information for volume 2. 

o Notifies you that no files or accounts were transferred. The 
account message, displayed at k, does not appear for volume 2 
because no accounts were transferred from volume 2. 

p Displays the volume summary information for each volume of the 
Backup Set, even when the totals are zero. 

q Reports the total statistics for the run. 

r Supplies statistics that describe the listing phase that 

generated the listing file. 


Loadindex File Example 

Loadindex allows you to copy a primary index file from a Backup Set to 
a RSTS/E formatted disk. To perform the transfer, run the RESTOR 
program, type Loadindex in response to the initial RESTOR prompt, and 
answer the resulting questions. During the dialogue, you specify the 
name and location of the Backup Set and the file into which the 
program is to copy the index. RESTOR then prompts you to mount the 
Backup Set index file, copies the index when the device is ready, and 
requests the dismount of the index file volume. Finally, RESTOR 
prints a listing file that summarizes the Loadindex operation. 

When you perform a series of restores, you must have access to the 
index file located on the last volume of the Backup Set. If you have 
not created an index file with Loadindex, created an auxiliary index 
file by copying the work file using PIP.SAV, or have given the work 
file a file type other than .TMP during the Backup operation, you must 
repeatedly load the last backup volume for each Restore operation. 

Use Loadindex to create an easily accessible index and eliminate this 
inconvenience. 

A discussion follows both the Loadindex example in the following 
section and the Loadindex listing file example in the section 
"Loadindex Listing File." 
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Loadindex Terminal Printout 

Log in to the system under account [1,110] and run RESTOR. The 
letters in the sample printout are keyed to the description that 
follows: 

$ RUN RESTOR?:RESTOR 
RESTOR V9.0 RSTS V9.0 

a RES[TORE], LOA[DINDEX] OR LIS[T] ? LOA 

b WORK FILE NAME<_SY:[ 1,110]B08SEP.TMP> ? LOADIN.WKF/MO:256 

C LISTING FILE<_KB:> ? LOADIN.LST 
d FROM DEVICE<_MM:> ? MMl:<RET> 

e TO FILE<_SY:[ 1,110]BIND08.IND> ? BACIND.IND 
f * <RET> 

g PLEASE ENTER BACKUP SET NAME<LOADIN> * BACKUP 
h PLEASE ENTER DENSITY IN BPI<800> - <RET> 
i PLEASE ENTER THE PARITY <ODD> - <RET> 


j MOUNT DEVICE: _MM : 

ID: BACKUP 

SEQ#: INDEX 

DENSITY: 800 BPI 

PARITY: ODD 


PLEASE MOUNT VOLUME WRITE LOCKED! 

1 DEVICE? MMl: 
m * <RET> 

n DISMOUNT DEVICE: _MM1: 

o $ 

The explanation of the Loadindex example follows: 

Line Description 

a Run the Loadindex dialogue by typing LOA or LOADINDEX in 

response to the initial RESTOR question. RESTOR understands 
only the first three letters of the option. 
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Line Description 

b Type LOADIN.WKF/MO:256 to store the work file on the public 

disk structure. Giving the specified file a file type other 
than .TMP allows you to use the work file as an auxiliary 
index file at some later date. However, if you accept the 
default or specify a. work file with a .TMP file type, RESTOR 
deletes the file at the end of the Loadindex run. The MODE 256% 
switch enables random data caching that facilitates data 
transfers within the LOADIN.WKF work file. For an explanation 
of the MODE 256% switch, see the RSTS/E Programming Manual. 

c Specify LOADIN.LST as the file into which RESTOR prints the 

listing file. RESTOR displays the listing file on your terminal 
if you accept the default. 

d Enter MM:, MS:, or MT: and press RETURN. 

e Have RESTOR copy the backup index to the file BACIND.IND. 

f Ignore the * prompt, which indicates that RESTOR is ready to 

accept interruption commands. 

g Respond by typing the Backup Set Name, in this case, BACKUP. 

h Press RETURN to accept the default density of 800 bpi for the 

magnetic tape. 

i Press RETURN to accept the ODD parity default setting for the 

magnetic tape. 

j Check the magnetic tape label information summary. 

k Make sure the magnetic tape is mounted write-locked and is at 

its load point. 

1 Type MMl:, which is the mnemonic name and unit number of device 

- on which the magnetic tape is mounted. 

m If you want to suspend processing temporarily at this point, 

type a RESTOR interrupt command. Because the operation is 
running smoothly, ignore the * prompt. Before RESTOR 
issues the dismount message at n, it copies the index file to 
the specified area. 

n Dismount the Backup index volume by typing the mnemonic name 

and unit number (followed by a colon) of the device on which 
the magnetic tape is mounted. 

o After RESTOR dismounts the Backup index volume, it gives the * 
prompt and returns control to your keyboard monitor. 
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Loadindex Listing File 

The Loadindex listing file summarizes the Loadindex dialogue, provides 
statistics on each phase, and lists the operations performed on each 
selected file. The letters in the file are keyed to the descriptions 
that follow: 


Restore Run Listing 

a Loadindex from '__MM : 

Run started on 13-Jun-85 at 12:03 PM 

Work-File is _SY :[1,110]LOADIN.WKF/MO:256 

To file : _SY :[1,110 JBACIND.IND 

b PHASE : LIST COMPLETE 
ERRORS : 0 

ELAPSED TIME : 1 SECONDS 
CPU TIME : .5 SECONDS 

KCTS : 72 

C PHASE : MOUNT / DISMOUNT COMPLETE 
ERRORS : 0 


ELAPSED 

TIME : 

60 

SECONDS 

CPU TIME 

• 

• 

.9 

SECONDS 

KCTS 

• 

• 

160 

PHASE 

: INDEX 

; LOAD COMPLETE 

ERRORS 

: 0 



CURRENT 

VOLUME 

• 

• 

_MM1 : 

ELAPSED 

TIME : 

1 SECONDS 

CPU TIME 

• 

.3 

SECONDS 

KCTS 

• 

• 

46 


PHASE 

: MOUNT 

1 / 

DISMOUNT COMPLETE 

ERRORS 

: 0 



ELAPSED 

TIME : 

12 

SECONDS 

CPU TIME 

• 

• 

.2 

SECONDS 

KCTS 

• 

• 

32 
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The explanation of the Loadindex listing file follows: 

Line Description 

a Summarizes the Loadindex dialogue described in the previous 

section. The summary shows the date and time of the Loadindex 
operation, the work file name, the name of the output file, 
and that the index resides on magnetic tape. 

b Provides time and error statistics about writing the dialogue 
summary into the listing file. 

c Lists the statistical details concerning the mount phase of the 

Backup Set index volume. 

d Describes which volume contains the index, the times required 
to complete the load, and the errors found during the 
index load phase. ' 

e Summarizes the dismount of the Backup Set volume. 


Index File Listing Example 

List initiates a set of dialogue questions like the other RESTOR 
modes. After you answer these questions, RESTOR creates a copy of the 
Backup Set index file, an index created by Loadindex, or, if specified 
during the Backup operation, an auxiliary index file. These files 
contain a directory listing of the Backup Set and a log of any errors 
found during the Backup operation. Before it can copy the index file, 
RESTOR asks for the index name and location and then asks where you 
want the index listed. As options, you can either list the index file 
at your terminal or place it in another file. Like the other RESTOR 
modes, a summary of the dialogue is written to the listing file. 

The example in the following section describes how to generate a list 
of an auxiliary index file. 


List Terminal Printout 

Log in to your system, run RESTOR, and then respond to the dialogue 
questions as shown. The letters in the printout are keyed to the 
description that follows: 

$ RUN RESTOR?:RESTOR 
RESTOR V9.0 RSTS V9.0 
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a RES[TORE], LOA[DINDEX] OR LIS[T] ? LIS 

b WORK FILE NAME_SY:[ 1,110]B08SEP.TMP> ? LIST.WKF/MO:256 

C LISTING FILE<_KB:> ? LIST.LST 
d INDEX FILE<PRIMARY> ? BACKUP.WKF 
e * <RET> 
f $ 

The explanation of the List example follows: 

Line Description 

a Type LIS and press RETURN in response to the first RESTOR 

question. 

b Specify LIST.WRK as the work file and attach the MODE 256% 

switch to optimize file transfer. See the RSTS/E Programming 
Manual for a description of MODE 256%. 

c Have RESTOR copy the listing file to LIST.LST. If you accept 

the default (KB:), RESTOR prints the index file at your 
terminal. 

d Type BACK.WRK to indicate which index file you want RESTOR to 

copy. In this case, specify the BACK.WRK file. Because you 
used a file type other than .TMP, namely .WRK, when you 
specified the work file name, RESTOR created BACK.WRK as a 
permanent auxiliary index file. After you completed the 
dialogue, RESTOR copied the BACK.WRK file to the listing file, 
LIST.LST. If you accept the default, RESTOR prints 
the FROM DEVICE question. In response, specify the device type 
on which the primary index volume is mounted. 

e Respond to the * prompt by pressing RETURN. The * prompt 

appears after you complete the dialogue and indicates that 
RESTOR is ready to accept interruption commands. After your 
response, RESTOR copies BACK.WRK to the LIST.LST listing file. 

f After copying the files, RESTOR displays the $ prompt and 

returns you to your keyboard monitor. 
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List Listing File 

The List listing file summarizes the List dialogue, provides 
statistics on the each phase of the operation, and prints a copy of 
the Backup index file. The following example is the listing file for 
the List operation described in the previous section. The letters in 
this listing file are keyed to the description that follows: 

Restore Run Listing 


List 

a Run started on 13-Jun-85 at 12:08 PM 

Work-File is _SY :[1,110]LIST .WKF/MO:256 

b PHASE : LIST COMPLETE 
ERRORS : 0 


ELAPSED TIME : 1 SECONDS 
CPU TIME : .5 SECONDS 

KCTS : 72 

C PHASE : INDEX LOAD COMPLETE 
ERRORS : 0 


ELAPSED TIME : 2 SECONDS 
CPU TIME : .4 SECONDS 

KCTS : 55 


d Backup Set Name : BACKUP 
Volume Sequence # : 1 
Creation Date : 13-Jun-85 
Density : 800 BPI 

Account : [1,110] 
Clustersize : 4 


Backup Device : _MM 
Owner : [1,110] 

Expiration Date : 13-Jun-86 
Parity : ODD 

Quota : 0 


Creation Access 


Name 

Ext 

Size 

Prot 

Date 

Time 

Date 

Clu 

RTS TSCD 

SAVE 

• DOC 

10 

60 

01 -Jun-85 

05:01 

PM 

01-Jun-8'5 

8 

...RSX*T 

OPEN 

. TMP 

0 

60 

10-Jun-85 

10:46 

AM 

10-Jun-85 

4 

BAS4F 

ADDR 

.DAT 

2000 

60 

09-Apr - 85 

10:46 

AM 

09-Apr-85 

4 

BAS4F T 


Errors : 

e DATA UNRELIABLE - FILE OPENED BY ANOTHER USER on FILE 

Total of 1 error encountered on FILE 


RT11 

.RTS 

20C 

60 

08-May-85 

04:39 

PM 

08-May-85 

4 

RSTS 

T 

SAVE 

. RNO 

9 

60 

09-Apr-85 

04:59 

PM 

09-Apr - 85 

8 

TECO 

T 

UTILTY.BAS 

47 

60 

13-Jun-85 

10:44 

AM 

13-Jun-85 

8 

BASIC 

T 

DIRECT.BAS 

56 

60 

13-Jun-85 

11:24 

AM 

13 -Jun-85 

8 

BAS4F 

T 
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* Attributes associated with this file 

Account total of 2142 blocks in 7 files on account [1,110] 
Total of 1 error encountered on ACCOUNT 

Account : [2,110] Quota : 0 

Clustersize : 4 





Creation 


Access 




Name Ext 

Size 

Prot 

Date 

Time 

Date 

Clu 

RTS 

TSCD 

BACKUP.BAS 

121 

42 

21-Apr - 85 

09:56 

AM 

21-Apr - 85 

8 

BASIC 

T 

BACFRM.BAS 

158 

42 

09-Apr - 85 

04:49 

PM 

0 9 -Ap r- 8 5 

8 

BASIC 

T 

BACKTO.BAS 

168 

42 

13 -Jun-85 

04:36 

PM 

13 - Jun-85 

8 

BASIC 

T 

MASTER.DAT 

6904 

60 

08-May-85 

10:55 

AM 

08-May-85 

4 

BAS4F 

T C 


(of 9000) 


***** File continued on next Volume ***** 

Account total of 7351 blocks in 4 files on account [2,110] 

***** Account continued on next Volume ***** 

g Volume total of 9493 blocks in 11 files in 2 accounts on volume _MM 
Total of 1 error encountered on VOLUME 


h Backup Set Name : BACKUP 

Volume Sequence # : 2(Index) 
Creation Date : 08-Sep-83 
Density : 800 BPI 

Account : [2,110] 
Clustersize : 4 


Backup Device : _MM 
Owner : [1,110] 

Expiration Date : 08-Sep-84 
Parity : ODD 

Quota : 0 


i 


Creation Access 

Name Ext Size Prot Date Time Date Clu RTS TSCD 

MASTER.DAT 2096 60 08-Sep-83 10:55 AM 08-Sep-83 4 BAS4F T CD 

of 9000) 


Account total of 2096 blocks in 1 files on account [2,110] 

j Volume total of 2096 blocks in 1 files in 1 accounts on volume _MM 

k RUN total of 11589 blocks in 11 files on 2 accounts on 2 Volumes 
RUN total of 1 errors 
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1 PHASE : LIST COMPLETE 

VOLUME # : 2 
ACCOUNTS : 2 
FILES : 11 
BLOCKS : 11589 
ERRORS : 0 

m ELAPSED TIME : 2 SECONDS 

CPU TIME : 1.7 SECONDS 

KCTS : 252 

The explanation of the List listing file follows: 

Line Description 

a Summarizes the List dialogue. This includes the name of the 

operation, the run date and time, and the work file name. 

b Provides statistics for the listing phase on writing the 

List dialogue summary into the listing file. Note that RESTOR 
rounds off elapsed time to whole seconds and CPU time to tenths 
of seconds. The elapsed time can therefore read zero while the 
CPU time is not zero. 

c Summarizes the index load phase that prints the elapsed time, 

CPU time, and the kilo-core ticks needed to load the index into 
the listing file. 

d Prints the Backup directory information extracted from the 

index file after it completes the List dialogue summary and 
reports on the various phases of the List operation. The 
directory report begins by listing the label information for 
the first volume of the Backup Set. It then displays a list 
of the files for each account on the directory. At the end of 
each account report, RESTOR prints the total number of blocks 
used by the files listed and the number of errors found 
on the account. 

In addition to supplying the file name, RESTOR includes in the 
account report the file block size, protection code, date and 
time of creation, date of last access, the cluster size, and 
the associated run-time system. The TSCD column contains a T 
for each restored file, an S for each superseded file, a C for 
a compared file, and a D for each deleted file. An asterisk 
beside a letter in the TSCD column indicates that the file has 
attributes associated with it. Zero-length files, such as 
OPEN.TMP in account [1,110], are not processed; thus, no 
letter is assigned to them in the TSCD column. Any errors in 
the dialogue sequence appear in the index. 
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Line 


f 

9 


m 


Description 

Prints the DATA UNRELIABLE message immediately after the file 

^cL» aUS6d . the ® rror * After enumerating the error messages, 
RESTOR prints the total.number of errors detected in the file. 

Summarizes the files contained in account [2,110]. 

Prints the total number of blocks, files, and accounts on the 
entire volume at the end of the account report. 

Prints label information found on the second volume of the 
Backup Set. 

Prints the account summary for volume 2. if there is more than 

*vtrZ° 1Ume in the Backu P Set, as there is in this example, 
RESTOR prints account and file information in the same format 
tor tne other volumes in the set. 

Summarizes the account that was transferred for the second 
vo ume of the set. Because there is only one account report, 
the volume and account totals are equal. 

Displays a summary of the blocks consumed by all the files on 
both volumes of the Backup Set. This completes the account and 
file statistics. 

Informs you that there are two volumes in the Backup Set, two 
accounts in the directory, and 11 files in the two accounts 
that require 11,589 blocks of disk space. In addition, an item 
in the list phase report indicates that there were no errors 
found during the printing of the list phase summary. 

Prints the time required to complete the list phase. 
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Obtaining System Status Reports: The SYSTAT Program 

The SYSTAT program provides current system information about jobs, 
devices, disks, buffers, run-time systems, resident libraries, message 
receivers, open files, and memory allocation. You can: 

o Display the report on a terminal 

o Send the report to a line printer 

o Write the report to a file 


Privilege Required 

To run the SYSTAT program, you need the following: 

o WREAD privilege to use the /0 and /W switches to obtain 
information about open files 

o SYSIO privilege to obtain status of temporary privileges for 
jobs 

o TUNE privilege to obtain maximum size, priority, and run 
burst information about jobs 

Running the SYSTAT Program 

To run SYSTAT, type: 

$ RUN $SYSTAT 

The program responds with a header and a prompt: 

SSYSTAT V9.0 RSTS V9.0 

Output.Status to? 
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At this point you can specify any RSTS/E device or a file 
specification for the status report output. Possible replies are: 


Meaning 

Displays report on your terminal. This is 
equivalent to KB: response. 

Sends the report to the system line printer if 
only one line printer is on the system or to 
line printer 0 if multiple line printers are on 
the system. 

Sends the report to line printer n if that 
printer is not currently in use. 

Displays the report on your terminal. This is 
equivalent to pressing RETURN for a response. 

Displays the report on terminal n in the system 
if that terminal is on line and not currently 
in use. 

Writes the report to the file specified. The 
default device is the system device. No file 
type is appended unless specified. 

Writes the report to a file on the public 
structure, and displays the file name on your 
terminal. SYSTAT names the file according to 
the current date and time of day; its type is 
• RPT. 

• An example of an output file created by the ? response is F04N59.RPT. 
The file name has four parts: 

o A letter, from A to L, denoting the month according to its 
alphabetical position; here, F denotes June. 

o Two digits, from 01 to 31, denoting the day of the month; 
here, 04 denotes the fourth day. 

o A letter, from A to X, denoting the hour from 00 to 23; here, 
N denotes the 14th hour (2:00 p.m.). 

o Two numbers, from 00 to 59, denoting the minute of the hour; 
here, 59 denotes the 59th minute. 



Output Response 
<RET> 

LP: 


LPn: 



KBn: 


dev:filename.type 
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To obtain a partial system status report, follow the device or file 
name specification with one or more of the switches listed in Table 


2-29. 


Table 2-29: SYSTAT Switches 


+ 

I 

+ 


Switch 

| Format 

1 

Meaning 


1 

1 


Attached 

1 

1 /A 

1 

| Report 

1 

status of attached jobs only. 

Busy devices 

/B 

| 

| Report 

status of busy devices only. 

Memory 

allocation 

/c 

1 

1 

i 

| Report 

1 

1 

memory allocation on system. 

Disk structure 

/D 

1 

| Report 

status of disk structure only. 

Free buffers 

/F 

1 

1 

| Report 

1 

status of free buffers only. 

Terminal 

/Kn 

1 

1 

i 

| Display report on terminal n in the 
j system. 

i 

Resident 

libraries 

1 /L 

1 

| 

i 

| Report 
j only. 

status of resident libraries 

Message 

receivers 

1 /M 

1 

1 

i 

| Report 

1 

| 

status of message receivers only. 

Job 

/n 

l 

1 

| Report 

l 

status of job n only. 

Account 

1 /n,m 

i 

| Report 

i 

status of account [n,m] only. 

Project 

/n, * 

1 

l 

| Report 
j number 

i 

status of jobs having project 
n only. 

Programmer 

1 _* >n 

1 

1 

| Report 
| number 

i 

status of jobs having programmer 
n only. 


null 

1 

1 

1 

1 

i 

| Report complete system status to include 
| jobs, run-time systems, resident 
| libraries, busy devices, disk structure, 

| free buffers, and message receivers. 

i 

Open files 

/o 

1 

| 

1 

| Report 
j open. 

all nonsystem files that are 


1 

| /0:dev 

1 

| Report 
j device 

all nonsystem files on a specific 
that are open. 


+ 

I 

+ 
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Table 2-29: SYSTAT Switches (Cont.) 


Switch 

1 

Format 

| Meaning 


1 


1 


I 

1 

1 

1 

1 

/w 

1 

| Report all nonsystem files that are 

I open, the jobs accessing them, and the 
j block number being accessed. 


1 

1 

1 

1 

1 

1 

/W:dev 

1 

| Report all nonsystem files that are 
j open on a specific device, the jobs 
| accessing them,' and the block number 
j being accessed. 

i 

Run-time 

systems 

1 

1 

1 

1 

/R 

1 

| Report status of run-time system only. 

Jobs 

1 

1 

1 

/s 

| Report status of jobs only. 

i 

Detached 

1 

1 

1 

/U 

1 

| Report status of detached jobs only. 

i 

Logged out 

1 

1 

1 

/0,0 

| Report status of jobs not logged into 
j the system only.. 


You can specify switches separately or in any combination. If you 
specify multiple switches, use only one slash (/) • 


The following examples show some typical SYSTAT switches: 


Example 


Result 


$ RUN §SYSTAT 

SYSTAT V9.0 RSTS V9.0 

Output Status to? STAT 

$ RUN $SYSTAT 

SYSTAT V9.0 RSTS V9.0 

Output Status to? LP:/3 

$ RUN $SYSTAT 
SYSTAT V9.0 RSTS V9.0 
Output Status to? /D 

$ RUN $SYSTAT 
SYSTAT V9.0 RSTS V9.0 
Output Status to? /SF 


Writes complete SYSTAT report in the file 
STAT in your current account on the 
public structure. 

Sends status report for job 3 to the line 
printer. 


Displays disk structure report on your 
terminal. 


Displays job status and free buffer 
reports on your terminal. 
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Contents of the Full Status Report 


The full SYSTAT report contains seven parts: 
o Jobs 

o Busy devices 
o Disk structure 
o Free buffers 
o Run-time systems 
o Resident libraries 
o Message receivers 

This section contains a complete SYSTAT report. For purposes of 
clarity, an explanation follows each part of the SYSTAT report. 


$ RUN $SYSTAT 

SYSTAT V9.0 RSTS V9.0 

Output Status to? <RET> 

RSTS V9.0 status at 13-Jun-85, 09:38 AM 


Job 

Who 

Where 

What 

Size 

1 

1,2 

Det 

ERRCPY 

11/32K 

2 

1,2 

Det 

OPSRUN 

22/32K 

3 

1,2 

Det 

QUMRUN 

23/32K 

4 

1,2 

Det 

SPLIDL 

22/32K 

5 

1,2 

Det 

BATIDL 

20/32K 

6 

1,2 

Det 

BATIDL 

20/32K 

7 

1,2 

Det 

BATIDL 

20/32K 

8 

1,2 

Det 

NPKDVR 

9/32K 

9 

1,223 

KB27 

...EDT 

7/32K 

10 

1,2 

Det 

EVTLOG 

26/32K 

11 

1,2 

Det 

MAILSN 

27/32K 

12 

1,223 

KB52 

...NET 

16/32K 

13 

1,229 

KB 41 

DCL 

4/32K 

14 

2,214 

KB32 

DCL 

4/32K 

15 

1,214 

KB51 

SYSTAT 

20/32K 

16 

1,2 

Det 

PBS..2 

14/32K 


Up: 67 

:52:51 



State 

Run-Time 

Pri/RB 

RTS 

SR 

2:58.2 

0/6 

..•RSX 

SL 

15.4 

-8/6 

...RSX 

SL 

9.1 

0/6 

...RSX 

SL 

3.5 

-8/9 

...RSX 

SL 

0.1 

-8/6 

...RSX 

SL 

0.1 

-8/6 

...RSX 

SL 

3.6 

-8/6 

...RSX 

SL 

17.0 

-8/6 

...RSX 

KB 

9:40.3 

-4/6 

...RSX 

SL 

3:26.2 

-8/6 

...RSX 

SR 

50.2 

-8/6 

...RSX 

SL 

1:02.4 

-8/6 

...RSX 

* C 

2:16.8 

-8/6 

DCL 

* C 

11.0 

-8/6 

DCL 

R Lck 

1:16.4 

-8/6 

...RSX 

SL 

6.4 

-8/6 

...RSX 
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The jobs report provides information about currently active jobs. 
Items reported are: 

Item Description 


Job 

Active job number. If a job is running with temporary 
privilege, the job number includes a plus sign (+). 

If the job is running without temporary privilege, the 
job number includes a minus sign (-). 

Who 

Account number under which the job runs. 

Where 

Number of the keyboard from which the job is running. 

An * character follows the keyboard number if the job 
logged- in by via a dial-up line. DET appears in place of 
the keyboard number for jobs running detached from a 
keyboard. The abbreviation PxJy appears for a job running 
on a pseudo keyboard. Px identifies pseudo keyboard 
number x and Jy denotes job number y, under which the 
controlling job is running. 

What 

Program name. 

Size 

Current size of the job and the size to which it can 
expand. 

State 

Current condition of the job. See Table 2-30 for the 
list of abbreviations used in this column. 

Run-Time 

Total amount of central processor run time used, in 
hours, minutes, seconds, and tenths of seconds. 

Pri/RB 

Current job priority and run burst units. 

RTS 

Name of the run-time system under which the job is 
running. 


Busy Devices: 


Device 

PRO 

Job Why 

17 Open 


PKl 17 Open 

DMP-0.0 TRN AS+Open 


DMP-1.0 
LPO 

TRN AS+Open 

23 Open 
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The busy devices report provides information about devices that are 
assigned or opened by a specific user. Items reported are: 


Item 

Device 


Description 


Device specification, 


Job 


Number of 

the job owning 

the 

device. 



Why 


Condition 

of the 

device. 

See 

Table 2 

-30 for the lis 



of abbreviations 

used 

in 

this 

column. 



Disk 

Structure: 








Dsk 

Open 

Size 

Free 

Clu 

Err 

Name 

Level 

Comments 

DM1 

0 

53768 

1891 

3% 

1 

8 

WRENCH 

1.1 

Pri, DLW 

DRO 

0 

500352 

69872 

13% 

8 

0 

H 

1.2 

Pri, R-O, 

DRl 

64 

131648 

8072 

6% 

4 

0 

ARK 

1.2 

Pub, DLW 

DR3 

25 

500352 

23672 

4% 

8 

0 

W 

1.2 

Pri, DLW 

DR4 

0 

242572 

163772 

67% 

4 

0 

M 

1.2 

Pri, DLW 

DR5 

0 

131648 

107500 

81% 

4 

0 

U 

1.2 

Pri, DLW 


The disk structure report provides information about each disk in use 
on the system. Items reported are: 


Item 

Dsk 

Open 

Size 

Free 

Clu 

Err 

Name 

Level 

Comments 


Description 

Disk name (device specification). 

Number of open files on the disk. 

Total number of blocks accessible on the disk. 

Number of free 512-byte blocks and the percentage of 
free blocks. 

Pack cluster size. 

Count of disk hardware errors. 

Pack identification or system logical name (if any) 
assigned to the device. 

RSTS System Device file structure. 

Comments on its status. The program reports disks 
assigned as non-file - structured and private and the 
report can include the job number and the designation 
"Dirty", if appropriate. See Table 2-30 for the list of 
abbreviations used in this column. 
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General FIP 

Buffers Buffers Jobs/Jobmax 
307 75 26/50 


Hung 

TTY'S 

0 


Errors 

294 


The free buffer report provides information about the number of small 
and File Processor (FIP) buffers available. Items reported are: 


Item 

General Buffers 

FIP Buffers 

Jobs/Jobmax 

Hung TTY's 


Errors 

Run-Time Systems: 


Description 

Number of small 16-word buffers that are generally 
available. 

Number of buffers available from the FIP buffer 
pool. 

Number of jobs currently running and the maximum 
number allowed to run (two numbers separated by a 
slash). 

Count of the number of times a hung terminal 
was found. A hung terminal is one that fails to 
respond to character transmission within a given 
time period. 

Total number of errors logged on the system. 


Name 

Ext 

Dev 

Size 

Users 

Comments 

...RSX 



0(32)K 

17 

Monitor 

RSX 

TSK 

DR1: 

1(28 ) K 

0 

Primary Perm, Addr:71, KBM 

DCL 

COM 

DR1: 

27(4 ) K 

4 

Temp, Addr:75, DF KBM 

RTll 

SAV 

DR1: 

4(28 ) K 

1 

Temp, Addr:106, KBM, CSZ, EMT:255 

BAS4F 

BAC 

DRl: 

15(16 ) K 

10 

Perm, Addr:62, KBM, CSZ 

TECO 

TEC 

DRl: 

10(20 )K 

0 

Temp, Addr:379:KBM 

BAS4AL 

BAC 

DRl: 

17(12 ) K 

0 

Non-Res, KBM, CSZ 

BASIC 

BAC 

DRl: 

13(16 ) K 

2 

Temp, Addr:206, KBM, CSZ 


The run-time systems report provides information about run-time 
systems. Items reported are: 


Item 


Description 


Name 

Name of the run-time system. 


Ext 

Default file type for (executable) 
that run-time system. 

files created by 

Dev 

Device location. 


Size 

Size of the run-time system, in K 

words. 
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Item Description 

Users Number of user jobs currently executing under control 

of the run-time system. 


Comments Information about the status of the run-time system. 

See Table 2-30 for the list of abbreviations used in 
this column. 

Resident Libraries: 


Name 

Prot 


Acct 

Size 

Users 

Comments 

HISTOG 

< 

42> 


[ 1,2 ] 

34K 

0 

Perm, 

Addr:1230 

EDT 

< 

42> 

DR1 

[ 0,1 ] 

21K 

2 

Temp, 

Addr:1209 

EDTV3 

< 

42> 

DRl 

[ 0,1 ] 

38K 

0 

Temp, 

Addr:1171 

RMSRES 

< 

42> 

DR1 

t 0,1 ] 

4K 

2 

Temp, 

Addr:1167 

RMSLBB 

< 

42> 

DRl 

[ 0,1 ] 

3K 

1 

Temp, 

Addr:1164 

RMSLBA 

< 

42> 

DRl 

[ 0,1 ] 

4K 

1 

Temp, 

Addr:1160 

RMSLBD 

< 

42> 

DRl 

[ 0,1 ] 

2K 

0 

Temp, 

Addr:1158 

RMSLBC 

< 

42> 

DRl 

[ 0,1 ] 

2K 

0 

Non-Res, Addr:1156 

RMSLBE 

< 

42> 

DRl 

[ 0,1 ] 

3K 

0 

Temp, 

Addr:1153 

RMSLBF 

< 

42> 

DRl 

[ 0,1 ] 

4K 

0 

Temp, 

Addr:1149 

B2MRES 

< 

42> 

DRl 

[ 0,1 ] 

19K 

0 

Non-Res, Addr:1130 

DAPRES 

< 

42> 

DRl 

[ 0,1 ] 

10K 

0 

Non-Res, Addr:1120 


The resident libraries report provides information about resident 
libraries. Items reported are: 

Item Description 


Name 

Prot 

Acct 

Size 


Name of the resident library. 

Protection code of the resident library. 
Account number of the resident library. 
Size of the resident library. 


Users Number of users accessing the resident library. 

Comments Information about the status and the starting memory 

location for the resident library. See Table 2-30 
for the list of abbreviations used in this column. 


Message 

Rcvrid 

Receivers: 
Job Rib 

Obj 

Msgs/Max 

Links/InMax/OutMax 

Access 

ERRLOG 

1 

0 

1 

0/4 0 

0/0/0 

Prv 

OPSER 

2 

0 

0 

0/30 

0/0/255 

Lcl 

QUEMAN 

3 

0 

6 

0/20 

0/0/255 

Lcl 

LP0SPL 

4 

0 

0 

0/5 

0/0/255 

Prv 

BA0SPL 

5 

0 

0 

0/5 

0/0/255 

Prv 
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BAlSPL 

6 

0 

0 

BA2SPL 

7 

0 

0 

MAIL 

8 

0 

27 

QM$CMD 

9 

1 

3 

QM$SRV 

9 

2 

4 

QM$URP 

9 

3 

5 

EVTLOG 

10 

0 

0 

EVTLSN 

10 

1 

26 

NWTT11 

11 

0 

24 

NWPK17 

17 

0 

23 

NWTT18 

18 

0 

24 

PR$26A 

26 

17 

65 

BA$26A 

26 

41 

66 

NSP 

NSP 

0 

0 


0/5 

0/0/255 

Prv 

0/5 

0/0/255 

Prv 

0/5 

0/1/255 

Net 

0/20 

0/0/255 

Prv 

0/10 

0/0/255 

Prv 

0/10 

0/0/255 

Lcl 

0/32 

0/0/255 

Evt, 

0/16 

0/8/255 

Net, 

0/5 

1/0/255 

Net 

0/16 

2/8/255 

Net 

0/5 

1/0/255 

Net 

0/5 

0/0/255 

Prv 

0/5 

0/0/255 

Prv 

0/0 

0/32/0 

None 


Prv 

Prv 


The message receivers report provides information about message 
receivers. Items reported are: 


Item 


Description 


Rcvrid 


Receiving job name. 


Job 

Rib 

Obj 


Receiving job number. 

Number of Receiver ID blocks (RlBs). 
Object type code. 


Msgs/Max Number of messages queued for the job and the 

declared maximum number of queued messages 
allowed. 


Links/InMax/OutMax Number of logical links in use and the maximum 

number of links allowed. 

Access Indicates whether local and network senders are 

allowed and whether the job can handle only one 
link. See Table 2-30 for the list of 
abbreviations used in this column. 
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Table 2-30 lists the abbreviations for a full SYSTAT report. 
Table 2-30: Abbreviations for Full SYSTAT Report 


Abbreviation 

1 

Meaning 

Job Status (State) 

?? 

1 

1 

Job's state cannot be determined. 

★ * f ★ ★ 

1 

1 

I 

Job is not logged in to the system. 

“ C 

1 

1 

1 

1 

Job is in CTRL/C state, awaiting input from the 
keyboard monitor. 

BF 

1 

1 

1 

1 

Job is waiting for buffers (no space is available 
for I/O buffers). 

CR 

1 

1 

Job is waiting for card reader input. 

DB,DF,DK,DL, 
DM,DP,DR,DS, 
or DU 

1 

1 

1 

1 

Job is waiting to perform disk I/O. 

DET 

1 

1 

1 

Job is detached from all terminals. 

DT 

1 

1 

1 

Job is waiting for DECtape I/O. 

DX 

1 

1 

I 

Job is waiting for flexible diskette I/O. 

FP 

1 

1 

1 

Job is waiting for file processing action by the 
system (opening or closing a file, file search). 

HB 

1 

1 

1 

I 

Job is detached and waiting to perform I/O to or 
from a terminal. 

KB 

1 

1 

Job is waiting for input from a terminal. 

LP 

1 

. 1 

Job is waiting to perform line printer output. 

MM,MS, or MT 

1 

1 

1 

Job is waiting for magnetic tape I/O. 

PP 

1 

1 

1 

Job is waiting to perform output on the 
high-speed paper tape punch. 

PR 

1 

1 

1 

1 

Job is waiting for input from the high-speed 
paper tape reader. 

RJ 

1 

1 

Job is waiting for RJ2780 I/O. 


+ 

I 

+ 

I 

+ 
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Table 2-30: Abbreviations for Full SYSTAT Report (Cont.) 


Abbreviation 

1 



Meaning | 

Job Status (State) | 


1 



1 

RN 

1 

1 

1 

Job 

is 

1 

running or waiting to run. | 

i 

RS 

1 

1 

1 

Job 

is 

waiting for residency. | 

1 

SL 

1 

1 

1 

Job 

is 

1 

sleeping (SLEEP statement). | 

l 

SR 

1 

1 

1 

Job 

is 

sleeping and is a message receiver. | 

1 

TT 

1 

1 

Job 

is 

1 

waiting to perform output to a terminal. | 


| The following status descriptions may appear after one or more of | 

I the other job state abbreviations: | 

+.+.+ 


| Lck 

I 

I 

| NSW 


| Swi 

I 

| Swo 

I 

| Xnn 


+ 

I 

+ 


| Job is locked in memory for the current 
j operation. | 

I I 

| Job has requested that it not be swapped from | 

j memory and cannot be swapped unless it requests | 

j additional memory. I 

I I 

| Job is currently being swapped into memory. | 

I I 

j Job is currently being swapped out of memory. | 

I I 

| Job is swapped out and occupies slot nn in swap | 

j file X; file is denoted by A,B,C, or D to j 

j represent files 0 through 3 of the swapping | 

j structure. I 

+..+ 

Busy Devices (Why) | 

+ -- --.+ 


| ANSI 

I 

I 

| AS 

I 

| DOS 

I 

I 

| OPEN 


Magnetic tape is assigned with ANSI standard 
labeling format. 

Device is explicitly assigned to a job. 

Magnetic tape is assigned with DOS labeling 
format. 

Device is open on a channel. 
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Table 2-30 s Abbreviations for Full SYSTAT Report (Cont.) 

4----------* +.." * 

I Abbreviation | Meaning 


+. 

1 

Disk Structure (Comments) 1 

+. 

| 1 

1 

| Dirty 

| 

| Disk needs cleaning. 

1 

1 

| DLW 

1 

1 

| Date of last write (modify), rather than date of 
j last access, is stored in file accounting | 

j entries. 1 

i 

i 

| Job n 

1 

| Private disk is assigned to job n. | 

1 

1 

| INI 

i 

1 . I 

| Disk is open in mode 512 or is being initialized 

| by DSKINT. 1 

i 

1 

| Lck 

i 

1 i 

| Disk is in a locked state. 1 

I 1 

i 

| NFF 

1 

1 

1 * 

| New files on this disk are put at beginning of | 

j directory. 1 

1 

1 

| NFS 

i 

| Disk is open as non-file - structured device. | 

1 

| PRI 

I 

j Cartridge or pack is private. 1 

1 

1 

| PUB 

i 

| Cartridge or pack is public. I 

1 

1 

| R-0 

+. 

| Disk unit is read-only (write-locked). | 


| Run-time Systems and Resident Libraries (Comments) | 

+...+.. 

j Addrrxxx j Denotes the starting address of the run-time | 


1 

j 

| system or library. I 

1 

| csz 

1 

| Proper job image size (in K words) to run a | 

j program can be computed as K-size=(filesize+3)/4. | 

i 

1 

| DF KBM 

1 

| Run-time system is the default keyboard monitor. | 

i 1 

| EMT:yyy 

I 

| Denotes the EMT code for special EMT prefix. | 

i l 

1 

| KBM 

1 

1 

| Run-time system can serve as keyboard monitor. | 

i 

1 

| Loading 

1 

i 

| Run-time system or library is being loaded into | 

j memory. I 

i l 

1 

I Monitor 

1 1 

1 Denotes monitor RSX emulation. 
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Table 2-30: Abbreviations for Full SYSTAT Report (Cont.) 

+.+.+ 

| Abbreviation | Meaning | 

+.+ 

| Run-time Systems and Resident Libraries (Comments) | 

+.+.+ 


| NER 


| Non-Res 

I 

| Perm 



Primary 

Rem 


I R/W 



Temp 


| 1US 


+ 

+ 



Evt 

Lcl 


| Net 

I 

| One 

I 

| Prv 



| Errors occurring within run-time system or | 

| library will not be sent to system error log. | 

I I 

| Run-time system or library is nonresident. | 

I I 

| Run-time system or library will stay in memory | 

| when not being used. j 

I I 

| Denotes the primary run-time system. | 

| Run-time system or library will be removed from j 
j memory as soon as all its jobs switch to another | 

| run-time system or library. | 

I I 

| Run-time system or library allows read/write | 

i access. j 

I I 

| Run-time system or library will be removed from | 

| memory when not being used. j 

| Run-time system or library can serve only one | 

j user. j 

+.+ 


Message Receivers (Access) 



Indicates the DECnet event logger. 


| Local senders are allowed for this receiver ID. | 

| Network senders are allowed for this receiver ID. j 

j User has indicated that job should handle only j 

j one network link. j 

I I 

| Local senders must have SEND privilege. | 

+.+ 
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Contents of the Open File Reports 

This section contains a description of the open file reports. Use the 
/0 switch to obtain the report about open files only. Use the /W 
switch to also include information about the jobs accessing the open 
files. The following example includes both the open files and the 
jobs accessing them: 


$RUN 5SYSTAT 

SYSTAT V9.0 RSTS V9.0 

Output Status to? /W 

Open files and jobs accessing them: 


DM0: 

- - None 



DRO: 

- - None 



DRl: 
DRl: 

-- File 

[ 1,204]TEMP27.TMP<60> 

Job 27 Block 3 

Op/RR Size 

1/0 6 

Rd, Wr, Tent 

Clu Status 

4 Tent 

DRl: 

[ 1,2 ]BATC 0 7.WRK < 6 0 > 

Job 7 Block 1 

1/0 9 

Rd, Wr 

4 

DRl: 

[ 50,50 ]MAIL .TSK<232> 
Job 24 Block 76 

• 

• 

0/1 620 

Rd, RR 

128 

Items 

• 

reported are: 



Item 


Description 


File 

Device, account, file name, file type, and protection 
code of each file opened on the system or specified device 

Op/RR 

Number of jobs that have the file opened (or opened in 
read regardless mode). 

Size 

File size. 



Clu 

Cluster size of the 

f ile. 


Status 

File status. See Table 2-31 for the 

list of abbreviations 


used in this column. 
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Item Description 


Job 

Job(s) accessing the file. 

Block 

Block being accessed. 

Access 

File access allowed for users. 

Table 2-31 

lists the abbreviations used in the Access column. 

Table 2-31: 

Abbreviations for Open File Reports 


.+.+ 

Abbreviation | Meaning | 


1 

+. 

I 

Open Files (Status) | 

1 I 

1 Ctg 

1 

1 

| File is contiguous. | 

1 | 

1 

| MDL 

i 

1 1 

| File is marked for deletion. | 

1 | 

1 

| NoK 

i 

| File cannot be renamed or deleted. | 

1 1 

| None 

1 ! 

| No files are open on the disk. | 

i 

| Pla 

1 

f File is placed. | 


System files | Only swap files or run-time systems are 


| only 

| open on the disk. | 

1 1 

1 

| Tent 

i 

| Tentative file. | 

1 I 

1 

| UFD 

1 

| File is a UFD-type entry. | 

| 1 

1 Upd 

-i-.. 

i 

| File is open in UPDATE mode. | 

.+.+ 

Jobs Accessing Open Files (Access) | 

+. 

i 

1 1 

1 

| Ca 

' 

| File is open for user data caching. | 

i i 

| Rd 

( 

. 

| User has read access to the file. | 

1 1 

1 

| RR 

1 

| File is open read regardless. | 

i i 

1 spup 

1 1 

| File is open in special UPDATE mode. | 

i i 

1 Sq 

1 

1 1 

| File is open for sequential user data | 

j caching. j 
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Table 2-31: Abbreviations for Open File Reports (Cont.) 

Meaning 


+.+ 

| Abbreviation | 

+.+. 

| Jobs Accessing Open Files (Access) 

+ 



1 


Tent 

1 

1 

1 

Tentative file. 

Up 

1 

1 

1 

File is open for UPDATE. 

Wr 

1 

1 

User has write access to the file. 


Contents of the Memory Allocation Report 

This section contains a description of the memory allocation report. 
The memory allocation report lists the starting and ending addresses 
for currently installed run-time systems and resident libraries. You 
can use this information to determine available addresses when 
installing new run-time systems and resident libraries. Use the /C 
switch to obtain the memory allocation report. 

The memory allocation report lists memory information about the 
following items: 

o Monitor (the resident portion), 
o XBUF (extended buffer pool, if present), 
o Locked out memory (if any). 

o Nonexistent memory (i-f any exists before the end of physical 
memory). 

o Resident libraries. 

o Run-time systems that were added at specific addresses or 
were loaded with the STAY attribute. 


Note 

The memory allocation report lists only those items 
assigned to specific addresses. The report does not 
reflect the dynamic state of memory. 
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The following example shows the memory allocation report: 

$RUN $SYSTAT 

SYSTAT V9.0 RSTS V9.0 

Output Status to? /C 


Memory allocation table: 

Start End Length Permanent Temporary 


OK - 

70K ( 

: 71K) 

MONITOR 



71K - 

71K ( 

IK) 

RSX RTS 



724K - 

850K ( 

• 

: 127K) 

** XBUF ** 



1120K - 

• 

1129K ( 

10K) 

(User) 

DAPRES 

LIB 

1130K - 

1148K ( 

# 

19K) 

(User) 

B2MRES 

LIB 

1264k - 

• 

1390k ( 

127k) 

Locked out 



1664K - 

*** END *** 





Items reported are: 


Item 

Start 

End 

Length 

Permanent 


Temporary 


Description 

Starting address of that portion of memory. 

Ending address of that portion of memory. 

Length of that memory segment. 

Those items allocated by INIT.SYS, and run-time systems 
and resident libraries that are permanently loaded. 

The program labels memory that is not permanently 
allocated in one of these as "User." 

Run-time systems and resident libraries that were added 
at specific addresses but not permanently loaded. 


SYSTAT as a CCL Command 

You can run SYSTAT with a CCL command if your system manager has 
defined it on your system. When you use the CCL command, you can 
include a file specification on the command line. Assuming that SYS 
is the CCL command, the following examples show how to run SYSTAT 
using this CCL command: 

$ SYS REP 
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SYSTAT creates file REP and writes a full status report to the file. 
The file resides in your current account on the public structure. 

$ SYS /B 

SYSTAT displays a busy devices report on your terminal. 

To write a particular report to a file, type the file specification 
followed by the appropriate switch. For example: 

$ SYS REP/B 

In this example, SYSTAT writes a busy devices report to the file REP. 
The default file type is .rpt. 
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Communicating with Other Terminals: The TALK Program 

The TALK program allows you to communicate with other terminals on 
your system. You can send a message to a user's terminal or to the 
system console. 


Privilege Required 

Usually your system manager assigns a protection code of <232>, which 
permits all users to run TALK. However, your- system manager can 
restrict the use of TALK by assigning a protection code of <124>. 

Check with your system manager to find out if you have access to TALK. 


Running the TALK Program 

TALK enables you to send line-by-line messages to another terminal. 

If the terminal user receiving your message wants to communicate with 
you, that user must also run TALK. Both the sending and receiving 
terminals must be on line, but a user does not need to be logged in to 
receive a message. 

To run TALK, type: 

$ RUN AUXLIB$:TALK 
TALK V9.0 RSTS V9.0 

After TALK prints its header, the program prompts you for the keyboard 
number of the terminal to which you want to send a message: 

To which keyboard? 

Press RETURN after you enter the keyboard number, 12, for example. 

TALK accepts a response such as KB12 but the KB prefix is optional. 

To make sure that you do not disrupt an elaborate printout on a user's 
terminal, it is good policy not to send a message to a terminal unless 
you know the type of activity the terminal user is performing. An 
unscheduled message can sometimes destroy hours of work. Use SYSTAT 
or DISPLY to determine the status of another user's job. If the job 
state is *C, then the job is at a keyboard monitor prompt and most 
likely your message will not interrupt the job. 

If you type the number of an offline terminal: 

o TALK does not issue an error message 

o TALK sends Messages normally, but they are never received 
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o TALK does not terminate when you press RETURN 

If you type the number of a nonexistent terminal: 

o TALK does not issue an error message 

o TALK terminates when you press RETURN 

Once you enter a keyboard number and press RETURN, TALK displays the 
following instructions: 

Enter message below (CTRL/Z to end): 

Message: 

To send a message, type a line and press RETURN. As long as you 
terminate a line by pressing RETURN, TALK displays the Message: prompt 
on the next line. 

To terminate the message and TALK, enter CTRL/Z at the Message: 
prompt. If you enter CTRL/Z at the end of a message line, TALK 
terminates and does not send that message line. For example: 

Enter message below (CTRL/Z to end): 

Message:Sending a test message 
Message:<CTRL/Z> 

$ 

On the receiving terminal, TALK displays the message line and 
positions the cursor at the beginning of the next line. To return to 
your keyboard monitor prompt, press RETURN. For example: 

$ ** KB51 ** Sending a test message 
(cursor here) RET> 

$ 


A Sample TALK Terminal Session 

This sample session represents a typical TALK dialogue. Maryann 
originates the TALK session from keyboard number 9 and communicates 
with Robert at terminal number 12. Notice that blank lines placed 
between lines of text, make the received message more readable. To 
send a blank line, press the RETURN key at the message: prompt. After 
determining that the terminal with which you want to communicate is 
not performing a critical operation, proceed as follows: 

$ RUN AUXLIB$:TALK 

TALK V9.0 RSTS V9.0 
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To which keyboard? 12 

Enter message below (CTRL/Z to end): 


Message 

Message 

Message 

Message 

Message 

Message 

Message 

Message 

$ 


Robert, <RET> 

<RET> 

Would you please take the RP06 disk, marked SYSGEN, from <RET> 
<RET> 

my cabinet and place it on line? I will be needing it <RET> 
<RET> 

later on. Thanks! Maryann <RET> 

< CTRL/Z> 


Robert's terminal automatically identifies the sending device by 
enclosing the terminal number within * characters at the beginning of 
each message line. 

$ ** kb 9 ** Robert, 

** KB9 ** 

** KB9 ** Would you please take the RP06 disk, marked SYSGEN, from 
** KB9 ** 

** KB9 ** my cabinet and place it on line? I will be needing it 
** KB9 ** 

** KB9 ** later. Thanks! Maryann 


Robert replies as follows: 

$ RUN AUXLIB?:TALK 
TALK V9.0 RSTS V9.0 


To which keyboard? 9 

Enter message below (CTRL/Z to end): 


Message 

Message 

Message 

Message 

Message 

Message 

Message 

Message 

Message 

Message 

$ 


Maryann, <RET> 

<RET> 

Found it! And, you probably thought it would be easy. <RET> 

<RET> 

Such a cabinet! (Just kidding.) Your RP06, labeled SYSGEN, <RET> 
<RET> 

is now on line. <RET> 

<RET> 

Robert 
<CTRL/Z> 


The message is displayed on Maryann's terminal as follows: 


$ ** KB12 ** Maryann, 

** KB12 ** 

** KB12 ** Found itl And, you probably thought it be would be easy. 
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** KB12 ** 

** KB12 ** Such a cabinet! (Just kidding.) Your RP06, labeled SYSGEN, 
** KB12 ** 

** KB12 ** is now on line. 

** KB12 ** 

** KB12 ** Robert 
$ 
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Appendix A 

The Batch Processor Control Language 


The OPSER-Based Batch P 
a control file that you 
processing without requ 
OPSER-Based Batch Proce 
is available for other 
particularly useful in 
interaction. For simpl 
the OPSER-Based Batch P 


rocessor can execute a stream of commands from 
create. This lets you submit jobs for 
iring terminal dialogue. Because the 
ssor runs from a pseudo keyboard, your terminal 
use during processing. Batch processing is 
data processing operations that do not require 
icity, the remainder of this appendix refers to 
rocessor as the Batch Processor. 


You can submit batch input from control files that you create using 
PIP or an editor on a random access device. For purposes of this 
description, input is dealt with as though it were on cards, where 
each card represents one record. Such input consists of batch 
processor control language statements and is called a batch stream. 

It is possible to execute multiple streams simultaneously by 
submitting multiple control files to the Batch Processor. The system 
manager controls whether you can run more than one batch stream. This 
section describes the Batch Processor language control statements and 
how to include them in Batch Processor control files. 


Privilege Required 

To submit jobs to the Batch Processor you need the following: 
o Read access to the files you are submitting, 
o Write access if you use the /DELETE switch. 
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Control Language Statements 

Batch Processor control statements consist of a command field, one or 
more specification fields, and a comment field, in the following 
format: 

$[command-field] [specification-field(s)] [Icomment] 

You must separate fields by one or more spaces and/or tabs. 

Control statements always require a command field, which can contain 
switches to control or limit the command. When appropriate, one or 
more specification fields follow the command field. The exclamation 
mark character is a comment prefix signifying that the information 
between the ! character and the line terminating character is a 
comment. The Batch Processor takes no action on comment information. 
Note that the comment character (!) only applies to command lines. If 
you include a comment in a data statement, the Batch Processor 
interprets the comment as data. 


Command Field 

The command field directs the Batch Processor to perform the operation 
you specify in the field. 

The command field has the format: 


$command[switch(es)] 

The elements of the command field are: 


Element 



command 


switch(es) 


Meaning 

The dollar sign ($) character is the control statement 
recognition character. It must always occupy the first 
character position. 

This specifies the function you want the Batch 
Processor to perform. A command begins in the second 
character position immediately after the $ character. 

This controls or limits the command. A switch, denoted 
by a slash (/)character, follows the command. You 
cannot include a blank between the command name and the 
switch. 


You can shorten command names and switch names to their first three 
characters. For example, you can use either $BAS or $BASIC. 
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Because you must use blanks to delimit fields within a control 
statement, you cannot include blanks within the command field. 


Specification Fields 

The command field supplies the objects on which the Batch Processor 
performs the operation you specify in the command field. Depending on 
the command, a specification field can consist of a device 
specification, a file specification, or an arbitrary ASCII string, any 
of which can be followed by switches. 

The specification field has the format: 

[filespec][/sw] [filespec][/sw]... 

Use blanks to separate multiple specification fields, and terminate 
the line with any line terminating character, for example RETURN, or 
an exclamation mark character if you include a comment. 

The / character signals the start of a switch. For example: 

XYZ.BAS/SOURCE 

This switch indicates that file XYZ.BAS is a source file. 

If you optionally omit all or part of the file specification, the 
Batch Processor assigns default values. See the section "File 
Specification Syntax" for a description of these defaults. 


Comments 

Use an exclamation mark ( l ) character to denote the start of a comment 
in a control statement. The Batch Processor interprets any text 
included between the ! character and the end-of-line terminator as a 
nonexecutable comment. 

You can use empty comment lines that include no text to force line 
spacing on the job log and thereby make the log more readable. An 
empty comment consists of $! followed immediately by pressing RETURN. 
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Control Statement Syntax 

Syntax rules for control statements follow: 

o Except for empty comment lines, you must include a command 
name in all control statements. If you omit the command 
name, the Batch Processor does not execute the control 
statement. If you include a command name that is not 
recognized by the Batch Processor, it displays an error 
message. 

o Subject to restrictions on individual commands, you can 
substitute an * wildcard character in the file name or the 
file type field of a file specification. See the Section 
"File Specification Syntax" for the description of file 
specifications. 

An * can refer only to files that already exist. If you 
include an * in the specification of a file that does not 
exist, the file specification is invalid. 

o If you include file names that are longer than six 

characters, the Batch Processor uses only the leftmost six 
characters. If you include file types that are longer than 
three characters, the Batch Processor uses only the leftmost 
three characters. 

o You can use switches in the command and specification fields 
of a control statement. Switches appearing in the command 
field are command qualifiers, and their function applies to 
the entire command. Switches appearing in specification 
fields apply only to the field in which they appear. If a 
switch in the specification field conflicts with a command 
field switch, the Batch Processor returns an error message. 

An unrecognizable switch invalidates the control statement in 
which it appears. 

o A physical command line can have a maximum of 120 characters. 

o The hyphen (-) character can indicate the continuation of a 
command. If a hyphen is the last character on a line, the 
Batch Processor interprets the next line as a continuation of 
the previous line. The continuation line, however, must 
begin with a $ character followed by a blank. If you use the 
hyphen, you must place it before any comment. 
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o You can use quotation marks (") in control statements to 

denote a literal text string or to override special character 
interpretation by the Batch Processor. For example, in 
command environments other than DCL, the exclamation mark (!) 
designates auxiliary library account [1,3] or an 
installation-defined account. In control statements however, 
the ! character denotes a comment. To prevent the Batch 
Processor from misinterpreting the ! character given as an 
account designator, include quotation marks. For example: 


$RUN "IUPDAT" 

As a result, the Batch Processor executes program UPDAT from 
the auxiliary library account. Without the quotation marks, 
the Batch Processor interprets the characters following the ! 
character as a comment. See Table A-l for a summary of 
special characters. 

The following example shows the syntax of control statements: 

$JOB/NAME=SMYTHE !FIRST JOB 
$! 

$!COMPILATION OF NEW SOURCE FILES 
$! 

^MESSAGE STARTING COMPILATIONS 
$BASIC XYZ/SOURCE XYZ.LIS/LIST XYZ/EXECUTE 
$BASIC ABC/SOURCE ABC.LIS/LIST ABC/EXECUTE 
$ ! 

SMESSAGE STARTING LISTING OUTPUT 
$! 

$PRINT *.LIS !ALL LIST FILES 
$ ! 

$EOJ 


Table A-l lists and describes the control statement special 
characters. 


Table A-l: Control Statement Special Characters 


+..-.+ 

| Character | 

+..+ 


..---- + 

Meaning | 

.+ 


Space 


Horizontal tab 


Separates fields in a control 
statement. Otherwise ignored unless 
embedded in a string delimited by 
quotation marks. 

Separates fields in a control 
statement. (Equivalent to one space 
(blank) character; otherwise ignored.) 
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Table A-l: Control Statement Special Characters (Cont.) 


Character 

1 

Meaning 

Hyphen(-) 

1 

1 

1 

1 

1 

1 

1 

As the last nonblank character in a 
control statement, indicates that a 
continuation line follows. If the 
statement contains a comment, the 
hyphen must be the last nonblank 
character before the exclamation mark. 

Exclamation mark ( ! ) 

1 

1 

1 

Indicates a comment unless embedded in 
a string delimited by quotation marks. 

Dollar sign ($) 

1 

1 

1 

1 

1 

Used as the first character in the 
first position of a control statement; 
causes control statement recognition. 

Slash (/) 

1 

1 

Denotes a switch (separates 


1 

1 

specification field from switch name). 

Asterisk (*) 

1 

1 

1 

Indicates a wildcard in place of the 
file name or file type. 

Colon ( : ) 

1 

1 

Separates the switch name from the 

Equal (*) 

1 

1 

argument. 

Quotation marks, (") 

1 

1 

1 

Used to open and close a string to 
preserve embedded spaces or to pass a 


1 

1 

1 

special character (for example, !) 
without interpretation by the Batch 
Processor. 

plus (+) 

1 

1 

Indicates file concatenation in SCOPY 


1 

1 

commands. 

comma (,) 

1 

1 

Separates file, device, and/or account 


1 

1 

specifications within a specification 
field, which allows multiple elements. 
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File Specification Syntax 

A file name is a string of one- to six-alphanumeric characters. You 
can include an asterisk (*) wildcard in place of a file name to denote 
all files of the specified type in the specified account. If 
necessary, the Batch Processor generates a default file name related 
to the time of day. 

A file type consists of a period immediately followed by a string 
containing three alphanumeric characters. 

The file type reflects the nature of the file. For example, a 
BASIC-PLUS source file has a .BAS file type. An asterisk (*) wildcard 
in place of a file type denotes all file types, including null types. 


Some 

standard file types are: 


File 

Type 

Meaning 


. CTL 

Batch control file 


.DAT 

Data file 


• DIR 

Directory file 


.BAS 

BASIC-PLUS source file 


.LIS 

List file 


.BAC 

BASIC-PLUS compiled output file 


.OBJ 

FORTRAN compiled output file 

'\ 

. SRT 

PDP-11 SORT-11 input, output, or 

listing file 

.MAP 

Task Builder map file 

. TMP 

Temporary file 


. B2S 

BASIC-PLUS-2 source file 


.TSK 

Task built executable file (from 

TKB) 

.FOR 

FORTRAN source file 

.SAV 

RTll run-time system executable 

file (from LINK) 


These file types are the defaults when you do not specify a file type. 
The Batch Processor determines the default file type based on the 
associated command and the file type expected. 
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Table A- 2 summarizes the default file types associated with particular 
commands. 

Table a-2: Command-Related File Specification Defaults 


Command 

1 

1 

Default 
File Type 

1 

Meaning 


$BASIC 

1 

1 

1 

.BAS 

.B2S 

| Input source file default (BASIC- 

| (BASIC-PLUS-2) 

| 

PLUS) 


1 

1 

1 

1 

.BAC 

.TSK 

| Output executable file default 
| (BASIC-PLUS) 

| (BASIC-PLUS-2) 



1 

1 

. LST 

1 

| Listing file default 

i 


$CREATE 

1 

1 

1 

.DAT 

| The file generated as output by CREATE 
| has a file type of .DAT 

I 

SDIRECTORY 

1 

1 

1 

I 

.DIR 

i 

| The directory listing file has a 

| type of .DIR 

1 

file 

$FORTRAN 

1 

1 

1 

.FOR 

1 

| Input source file default 

1 



1 

1 

1 

.OBJ 

1 

| Output object file default 



1 

1 

.LST 

1 

| Listing file default 

| 



1 

1 

• SAV 

1 

| Executable linked file 

i 


$ JOB 

1 

1 

1 

1 

. CTL 

| Batch control file default; assumed when 
| the batch job is on a file - structured 
j device 

i 


1 

1 

.LOG 

| Batch output log file default 

1 


SPRINT 

1 

1 

1 

.LIS 

| Default file type for files that 

you type 

$RUN 

1 

1 

1 


| Checks internal default runnable 
| type list for installed run-time 

j 

file 

system 

SSORT 

+. 

1 

1 

. SRT 

| Input or output file default 
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When you omit file name and file type elements, the Batch Processor 
assigns default file names and file types. 

Table A-3 describes the file specification defaults. 

Table A*3: File Specification Defaults 


Condition 


Default 

| Example | 

File name, but 
file type 

1 

no | 

1 

1 

1 

1 

1 

Default assigned as 
appropriate to the current 
operation. For example, 
with the $BASIC command, 
the default is .BAS. 

1 | 

| ABC=ABC.typ | 

1 | 

1 | 

1 | 

File name, followed j 
by period, but no 
file type j 

1 

Default file type is null. 
No file type is assigned. 

1 | 

| ABC.=ABC | 

1 | 

File type, but 
file name 

i 

no | 

1 

1 

1 

1 

Default file name is 
related to time of day. 

1 | 

| .LIS=B2347P.LIS j 

1 | 

| (created at j 

j 01:23:47 PM) 

| | 

No file 
specification 

1 

1 

1 

1 

1 

Default file name (related 
to time of day) with 
default type as 
appropriate to current 
operation. 

1 | 

| Null=B2347P.typ j 

1 | 

1 | 

1 | 


Switch Syntax 

Switches consist of a slash (/) character followed immediately by a 
name. If the switch takes an argument, use a colon (:) or equal (=) 
symbol to separate the argument from the switch name. If the switch 
takes an argument and subarguments, use a colon to separate the 
argument and each subargument. For example: 

/NAME*JOB3 
/FOR:F:512 

You can negate switch values by prefixing the switch name with NO. 
For example: 

/NOOBJ 
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This switch tells the Batch Processor not to produce an object file. 

The NO prefix is not considered part of the switch name. Thus, a 
negated switch must contain at least five characters. For example, 
the switch /NOOBJ or /NOOBJECT is valid; /NOO is invalid. 


Commands 

Table A-4 lists the Batch Processor command set and their meanings. 
The sections that follow explain each command in detail. 

Table A-4: Batch Processor Command Set 


Command 

| Function 

$ JOB 

| Begins a job 

1 

$EOJ 

1 

| Ends a job 

1 

$ BASIC 

| Executes the BASIC-PLUS interpreter or 
| BASIC-PLUS-2 compiler 

$DELETE 

1 

| Deletes files 

1 

$COPY 

| Copies files 

1 

$PRINT 

1 

| Queues a file for the default line printer 

$DIRECTORY 

1 

| Lists an account directory 

i 

$CREATE 

| Creates a file from data in the input stream 

$RUN 

1 

| Executes a program 

i 

$DATA 

1 

| Begins data images 

$EOD 

| Ends data images 

SMESSAGE 

1 

| Logs a message on the operator services 
| console 

$MOUNT 

| Assigns a device 

5DISMOUNT 

1 

| Deassigns a device 

1 

$SORT 

| Executes the PDP-11 SORT-11 program 

1 

$FORTRAN 

| Executes the FORTRAN compiler 
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Table A-4: Batch Processor Command Set (Cont.) 


Command 

1 

Function 

CCL system command 
or 

$ system command 

1 

| Executes a 

1 

1 

system utility function 


Note 


The $BASIC, $FORTRAN, and $SORT commands are subsets 
of BASIC, FORTRAN, and SORT capabilities. To use the 
full capabilities of BASIC, FORTRAN, or SORT, use the 
$RUN command. 


The $JOB Command 

This command marks the beginning of a job. 
has the format: 


$JOB[/sw] [proj,prog] 


The $JOB control statement 


You can use the following switches with the $JOB command: 


Switch 


Meaning 


/NAME*j obname 



/NONAME 


/LIMIT*nnn 



Assigns a name to the job. Jobnames can be up to 
six characters long. This name overrides the 
control file name as the identifier of the job. 

Indicates that no jobname is defined. The Batch 
Processor assigns a default jobname. The default 
jobname is the control file name. This name 
appears in all messages to the system operator. 

Assigns an elapsed time limit to the job. The Batch 
Processor interprets the value of nnn, a decimal 
number, as minutes. That the elapsed time required 
to execute a job is heavily dependent on overall 
system load. 
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Switch Meaning 


/NOLIMIT 

Gives the job an unlimited amount of elapsed time 
to complete. If you do not specify either /LIMITinn 
or /NOLIMIT, the Batch Processor allows ten 
minutes for the job to complete. After ten 
minutes, the Batch Processor terminates the job. 

/CPUinnn 

Assigns a CPU time limit to the job. The Batch 
Processor interprets the value of nnn, a decimal 
number, as seconds. If you specify /CPU but not 
/LIMIT, the Batch Processor does not enforce any 
elapsed time limit, but does enforce the CPU time 
limit. If you specify both switches, the Batch 
Processor enforces both limits. If you omit a CPU 
time limit specification, the Batch Processor 
allows unlimited CPU time. 

/NOCPU 

Gives the job an unlimited amount of CPU time to 
complete. This is the default. 

/QUE 

Queues the batch log file to LPO: (default) or the 
device specified at system start-up. 

/NOQUE 

Inhibits printing the batch log file. 


/PRIORITY:n Sets the RSTS/E job priority to n (or the next 


/DCL 

lowest multiple of 8) for the batch stream. 

The value of n can be between -120 and +127. 

Unless otherwise specified by the /PRIORITY:n 
switch, all jobs run at -8 priority. 

Disables all current commands that conflict with 
DCL commands and allows DCL to process them. 

/CCL 

Allows the use of the system's interactive Concise 
Command Language (CCL). When you specify this 
switch, you can include any CCL command that does 
not conflict with control statement commands after 
the $ character. The Batch Processor makes sure 
that the job is waiting for input for the keyboard 
monitor (the “C state reported by SYSTAT) before 
executing the command. 
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Switch Meaning 

/ERROR:n Specifies the level of error that the Batch 

Processor allows without terminating the job. 
Specify the error level you want with n, which can 
be: 

FAT[AL] BATCH tolerates all errors 

WAR[NING] BATCH tolerates warning errors, but a 
fatal error terminates the job 

NON[E] Any error terminates the job 

If the Batch Processor terminates a job because of 
an error, termination occurs-at the next request 
for input. The Batch Processor writes a message 
explaining the termination in the log file. The 
system manager determines the default error level 
for the batch stream at start-up time. 

Note 

See the RSTS/E System User's Guide for the severity 
standards in error messages. Some programs (for 
example the FORTRAN IV compiler) which operate under a 
run-time system other than BASIC-PLUS do not use the 
standard severity characters in error messages. 

Therefore, the Batch Processor does not detect 
compilation errors. User programs coded to run under 
batch control must use standard severity characters. 

You can include the following within the $JOB command: 

[n,m] You can execute a job from an account other than the account 
under which you queued the job. The specification field 
indicates the account you want. Use spaces to separate 
specification fields from other parts of the control 
statement. For example: 

$JOB/NAME=TEST/NOLIMIT/CCL [1,2] 
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The following $JOB command error conditions are possible: 
o Unrecognized switch 
o Illegal switch value 

o Multiple conflicting specifications (switches) 
o Different account specified 
o Higher priority desired 


The $EOJ Command 

This command marks the end of a job. The Batch Processor deassigns 
all devices previously assigned by the job when $EOJ executes. The 
Batch Processor performs a logical deassignment, then prints an 
message indicating that the operator should dismount the physical 
device. 

The $EOJ command is implied when the Batch Processor finds a physical 
end-of-file (EOF) condition or another $JOB control statement while 
processing a control file. 

No switches or file specifications are legal in the $EOJ command. 


The $BASIC Command 

The $BASIC command calls a BASIC compiler to compile a source program. 
The $BASIC command has the format: 

$BAS[IC]t/sw] specification-field[/sw] [spec-field[/sw]]... 

When $BASIC appears in the control file, the Batch Processor assumes 
that BASIC-PLUS is the default keyboard monitor. If this is not the 
case and you want to use the BASIC-PLUS compiler, use the DCL command 
SET JOB/KEYBOARD_MONITOR=BASIC to switch to the BASIC-PLUS keyboard 
monitor before issuing the SBASIC command in the control file (see the 
RSTS/E Quick Reference Guide). 
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The $BASIC Command Field 

This section describes the command field part of the $BASIC command. 
It has the format: 

$BAS[IC][/sw] [specification-field[/sw]] [spec-field[/sw]]... 

The switches in the $BASIC command field are: 

Switch Meaning 


/BP1 


/BP2 


/RUN 


/NORUN 


/LIST 


/NOLIST 


Tells the Batch Processor to use the BASIC-PLUS 
compiler. If you do not specify either /BPl or /BP2, 
the Batch Processor assumes /BPl. The default file type 
is .BAS. 


Tells the Batch Processor to use the BASIC-PLUS-2 
compiler. If you do not specify either /BP2 or /BPl, 
the the Batch Processor assumes /BPl. The default file 
type is .B2S. 


Tells the Batch Processor to execute only a previously 
compiled/task built program. If you use this switch, 
the entire command line must include only one file 
specification. The only other switch you can use is 
/EXECUTE. 


Tells the Batch Processor to perform the 
compile/task-build procedure, but not to execute the 
final file. 


Tells the Batch Processor to produce the listing file 
filename.LST, where the file name is the source file 
name. The default is /NOLIST. 

Tells the Batch Processor to not produce a listing 
file. This is the default. 


/EXECUTE Tells the Batch Processor to create an executable file, 

whose file name is the source file name. To select a 
default file type, the Batch Processor uses these 
rules: 

o The file type is .BAC for BASIC-PLUS. 

o The file type is .TSK for BASIC-PLUS-2. 

/NOEXECUTE Tells the Batch Processor that if an executable file 

is needed, to create a temporary file and delete the 
file after executing the $BASIC command. 
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The following switches imply /BP2 causing BATCH to run BASIC - PLUS - 2: 


Switch 


Meaning 


/OBJECT 


/NOOBJECT 


/MAP 


/NOMAP 


Create the object file filename.OBJ, where the file 
name is that of the source file. This switch causes a 
task build operation. Thus it is legal only with 
BASIC-PLUS-2. 

Create the object file filename.TMP, where the file 
name is that of the source file. Delete this .TMP 
(temporary) file upon completing the command. 

Create the task builder map file filename.MAP, where 
the file name is that of the source file. This switch 
causes a task build operation. Thus, it is legal only 
in a BASIC-PLUS-2 run. The default is /NOMAP. 

Do not create a map file. This is the default. 


The $BASIC Specification Field 

This section discusses the specification field part of the SBASIC 
control statement. It has the format: 

$BAS[IC](/sw] specification-field[/sw] [...] 

You can include more than one specification field in the command. The 
legal switches can vary depending on the position of the field on the 
command line. 

The $BASIC command directs BATCH to search for a source file. The 
command looks for a specification field containing the /SOURCE switch 
or a field that has no switch. SBASIC then assumes this field to be 
the input file for the command. For this reason, only one file 
specification can appear without switches. In addition, this 
specification can not contain * or ? wildcards. 

If you do not specify a source file, you must follow the SBASIC 
command with a set of BASIC source statements, terminated by either 
SEOD (see the section "The $EOD Command") or some other recognizable 
batch control statement. For example: 

$BAS LSTING/LIS 
BASIC 
Source 
Deck 
SEOD 
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If you explicitly specify a source file, BATCH appends any source 
statements following this command. If any source statements that 
follow this command have line numbers equal to those in the source 
program, BATCH replaces those lines in the source program. You must 
provide source input either through either a file specification or 
source statements, or both. 

Because you can use switches in both the command field and 
specification field, you must avoid specifying conflicting switches. 
Moreover, you cannot use each switch more than once in the entire 
$BASIC command line, nor can you use a switch and its negation 
anywhere in the same command line. For example, /LIST and /NOLIST 
cannot appear together in a command line. 

You can use the following switches in the first specification field of 
the control statement: 


Switch 

/SOURCE 

/BASIC 

/EXECUTE 


Meaning 

Both switches mean that this is the BASIC-PLUS or 

BASIC-PLUS-2 source file on which to operate. 

This switch is legal only if /RUN appears in the command 
field, and means that this is an executable file. 


When you specify a file without a switch, BATCH applies the default 
/SOURCE. If /NORUN appears in the command field, the absence of a 
switch here implies /BASIC. If /RUN appears in the command field, the 
absence of a switch here implies /EXECUTE. If either /RUN or /NORUN 
does not appear in the command field, the absence of a switch here 
implies /BASIC. 

You can include additional specification fields in the command line to 
define other files that you may need in the operation. You can use 
any of the following switches: 


Switch 

/LIST 


/OBJECT 


Meaning 

Define the listing file as specified. If you specify the 
/LIST switch but do not include a listing file, the 
Batch Processor creates the default listing file. If you 
specify a file specification with the /LIST switch, the 
Batch Processor uses that specification for the file. To 
print the specified file as part of the Batch job, 
supply a $PRINT control statement (see the section 
"The $PRINT Command"). 

Define the object file as specified. This switch implies 
/BP2 and causes BATCH to run BASIC-PLUS-2, with task 
build. Therefore, it is legal only with BASIC-PLUS-2. 
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Switch Meaning 

/map Define the map file as specified. This switch implies 

/BP2 and causes BATCH to run BASIC - PLUS - 2, with task 
build. Therefore, it is legal only with BASIC-PLUS-2. 

/EXECUTE Define the executable file as specified. If you do not 

specify an executable file with the /EXECUTE switch, 
BATCH creates a default executable file and deletes it 
after job completion. If you explicitly specify an 
executable file, BATCH preserves it after job execution. 

Errors result from conflicting switch specifications such as placing 

both /BASIC and /SOURCE on different specification fields. 

The following error conditions are possible: 


o Unrecognized switch 

o Multiple conflicting specifications (switches) 
o File specification syntax error 


The $DELETE Command 

The $DELETE command deletes files you specify. It has the format: 

$DEL[ETE] file - specification [ ...] 

You must include the file name and file type.. You cannot use the * 
wildcard character in either 'the file name or the file type field. 

You cannot use switches with the SDELETE command. 

The following error conditions are possible: 

o No file specification 

o Syntax error in file specification 
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The $COPY Command 

The $COPY command copies files. The control statement has the format: 
$COP[Y] filelt/sw] [file2...filen] 

Follow the command field with a list of file specifications, separated 
by spaces. You cannot use the * wildcard character in the file 
specification. The following are the valid switches: 

Switch Meaning 

/OUTPUT To create new files 

/INPUT To copy existing files 

If you do not specify a switch, the Batch Processor assumes the 
default, /INPUT. For example, in the following command, the Batch 
Processor assumes TERRY.LIS is the input file: 

$COPY TER.LIS/OUTPUT TERRY.LIS 

You can use the plus sign (+) character to direct COPY to concatenate 
files. Place the + character in the file specification field between 
the specifications of files you want to concatenate. The Batch 
Processor concatenates the files to create a single file. For 
example: 

$COPY MERGE.LIS/OUTPUT DATAl.LIS+DATA2.LIS+DATA3.LIS 

This command directs the Batch Processor to create a file named 
MERGE.LIS, copy the contents of DATAl.LIS to that file, and append the 
contents of DATA2.LIS and DATA3.LIS to that file. DATA3.LIS follows 
DATA2.LIS. 

The following error conditions are possible: 
o No output specification 
o No input specification 
o Multiple conflicting specifications 
o Syntax error in file description 
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The $PRINT Command 

The $PRINT command prints the contents of files on the system line 
printer by invoking spooling program SPOOL. File specifications 
accept all switches available in the Q command. You can use the * 
wildcard in file specifications. The $PRINT command has the format: 

$PRI[NT] filel[/sw] [file2[/sw] ... filen] 

The specification field contains the file or files you want to print. 

The following error conditions are possible: 

o No file specification 

o Syntax error in file specification 


The $DIRECTORY Command 

The $DIRECTORY command produces a directory listing of the file(s) in 
the account you specify, and has the following format: 

$DIR[ECTORY] (specification field] 

The specification field can contain full RSTS/E file specifications. 
If no file specification appears, the $DIR command lists the contents 
of the current account in the Batch log file. A file specification 
indicates the directory of a file or set of files and can contain an 
asterisk (*) wildcard in either the file name field or file type 
field. For example: 

?DIR *.BAS 

This command creates a directory listing of all files in the current 
account with the .BAS file type. 

You can use the /DIRECTORY and /INPUT switches in the control 
statement. The following text shows their use. 

To create a directory in a disk file rather than on the batch log 
device, specify a file and the /DIRECTORY switch. For example: 

$DIR BAJOB.DIR/DIR 

This control statement creates the directory listing in a file 
BAJOB.DIR on the system disk under the current account. 

To create a directory in a disk file and to designate the files you 
want to list, specify both the /DIRECTORY and /INPUT switches in the 
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related file specification. For example: 

$DIR BA.DIR/DIR *.BAC/INPUT 

The $DIR command in this example creates a directory listing of all 
compiled BASIC-PLUS (.BAC) files and stores the listing in the file 
BA.DIR on the system disk under the current account. 

The following error conditions are possible: 

o Syntax error in file specification 

o Multiple conflicting specifications 


The $CREATE Command 

The $CREATE command creates the ASCII file you specify in the file 
field. The 5CREATE command has the format: 

$CRE[ATE] file 

<data> 

$EOD 

The file contains the data following the $CREATE command in the input 
stream. If you do not terminate the data (which must follow the 
$CREATE command) with $EOD, the Batch Processor returns an error 
message. No other command can precede the data because the $CREATE 
function terminates on finding a $ in the first column of a line. 

At batch execution time, the Batch Processor deletes any existing file 
having the same name, and replaces it with the file that $CREATE 
creates. 

The following error conditions are possible: 
o Syntax error in file specification 
o No file name specified 

o Characters other than a ! character following file 
specification 
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The $RUN Command 

The $RUN command executes system programs. The command line has the 
format: 

$RUN [ppn] program [command line] 

The $RUN command allows no switches. If you omit the program name, 
the Batch Processor uses the current program as the default. For 
example, to run PIP, type: 

$RUN $PIP 

Follow the PIP command with the appropriate command line. The PIP 
program reads the commands as data images in the input stream. The 
Batch Processor terminates PIP when it reads the next control 
statement. 

The following error conditions are possible: 
o Syntax error in file specification 

o Noncomment characters (any character that is not a I 
character) following file specification 


The $DATA Command 

The $DATA command lets you supply data to a program that one of the 
language commands ($BASIC, $FORTRAN) compiles and runs. $DATA makes 
sure that the Batch Processor runs the program, unless you include the 
/NORUN switch. The Batch Processor discards any remaining data that 
the program does not use. 

Issue the $DATA command without specification fields or switches, in 
the format: 

$DATA 

<data> 

$EOD 


A- 22 



The Batch Processor Control Language 


The $EOD Command 

The $EOD command marks the end of data records you include in the 
input stream following commands such as $BASIC, $CREATE, $DATA, and 
$RUN. For example: 

$DATA 

<data> 

$EOD 


The $MESSAGE Command 

The $MESSAGE command logs a message on the operator services console. 
It provides a way for the job to communicate with the operator. The 
$MESSAGE command has the format: 

?MES[SAGE][/WAIT] message-string 

The /WAIT switch directs the system to pause and wait for operator 
action. The system pauses until the operator gives the appropriate 
command. For example, the following command halts the program until 
the operator takes action: 

$MESSAGE/WAIT MOUNT SCRATCH TAPE ON DTO: 

The WAIT condition remains in effect until the operator responds to 
the message on the operator services console. See the RSTS/E System 
Manager's Guide for information on operator response procedures. 


The $MOUNT Command 

The $MOUNT command directs the Batch Processor to print a mount 
message on the operator service console, and to create a logical to 
physical device assignment. After the message appears, an automatic 
/WAIT occurs. The operator responds with the device and unit number 
in the standard format (for example, MT1:). The $MOUNT command has 
the format: 

$MOU[NT] devn:[/sw] devm:[/sw] 
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You must specify both the logical device and the physical device. Use 
a colon to terminate each device specification. You can use the 
following switches for the physical device: 


Switch 

Format 

Description 

Physical 

/PHY 

Identifies the device specification to 
be the physical device (default). 

Write 

/WR 

Tells the operator to write-enable the 
device (or volume). 

No write 

Visual 

/NOWR 

Tells the operator to write - protect the 
volume. 

identification 

/VID=[name] 

Identifies the volume for the operator 
with [name], which is a visual 
identification. 

Density 

/DEN:nnn 

Specifies density for magnetic tape. 

Parity 

/PAR:ODD 
/PAR:EVEN 

Specifies odd parity for magnetic tape. 
Specifies even parity for magnetic 
tape. 

You can use the 

following switch with the logical device: 

Logical 

/LOG 

Identifies the device specification to 


be the logical device name. BATCH 
accepts logical device names up to six 
characters. For RSTS/E disks, this 
specification must correspond to the 
PACK ID. 

The /VID switch on the physical device field specifies the volume 
identification. The value associated with /VID is the name physically 
attached to the volume. Include this switch to help the operator 
locate the volume. The volume identification cannot contain slashes 
(/), commas (,), or embedded blanks. If you must include blanks in 
the /VID string, enclose the name in quotation marks (")• 

The following example shows the use of the $MOUNT command: 

$MOUNT MT:/PHY/VID«"MY TAPE" TAPE:/LOG 

In this example, the Batch Processor assigns the logical device name 
TAPE to a magnetic tape unit. The logical device name notifies the 
operator that the reel of tape you want physically mounted is labeled 
MY TAPE. The operator uses a PLEASE command to respond with the 
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device and unit number on which the tape is mounted (see the RSTS/E 
System Manager's Guide). Thereafter, in the control file, reference 
to device TAPE: accesses the physical device on which the operator 
mounted the reel labeled MY TAPE. if the physical device is a 
removable disk pack or cartridge, the logical device name must be the 
pack identification. The Batch Processor logically mounts and unlocks 
private disks that the operator mounts as a result of $MOUNT. 


The valid physical devices that you can request for mounting are: 


Dev 


Physical Device 


CR: 

DK: 

DP: 

DB: 

DM: 



DT: 

DU: 

LP: 

MT: 

MM: 

• MS: 
MU: 
PP: 
PR: 
SY: 
KB: 


Card Reader 

RK11/RK05 Disk Cartridge 
RP11/RP03/RP02 disk pack 
RH11/RP04/RP05/RP06 disk pack 
RK611/RK06/RK07 disk pack 
RM02/RM03/RM05/RM80 disk pack 
RHll disk 
RL01/RL02 disk 
RX01/RX02 flexible diskette 
TU56 DECtape 

RA6 0/RA8 0/RA81/RC2 5/RD51 disks 
Line printer 

TE10/TU10/TS03 magnetic tape 

TE16/TUl6/TU77/TU45 magnetic tape 

TS11/TSV05/TU80 magnetic tape 

TU81 magnetic tape 

Paper tape punch 

Paper tape reader 

System device 

Terminal 


The 




following error conditions are possible: 

o Syntax error in device specification fields 
o Invalid device name/unit 

o Invalid logical device name specifications 
o Unit number already assigned 

o Both physical and logical names have not been specified 
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The $DISMOUNT Command 

The $DISMOUNT command cancels the logical to physical device 
assignment you created using the SMOUNT command. It also prints an 
operator message, requesting that the volume be physically dismounted. 
If you include a /WAIT switch in the command field, the job does not 
resume until the operator types a response, as with the $MESSAGE 
command. The $DISM0UNT command has the following format: 

$DIS[MOUNT][/WAI[T]] logical device name: 

Using the example from the $MOUNT description, the following command 
dismounts the device: 

SDIS/WAI TAPE: 

This command sends a message to the operator to dismount the magnetic 
tape that was mounted in previous example. The /WAI switch instructs 
the Batch Processor to pause until the operator responds. 

The Batch Processor automatically dismounts all devices at end-of-job 
(EOJ). 

The following error conditions are possible: 
o Syntax error in specification field 
o Illegal switches 
o Logical device not assigned 


The $SORT Command 

The $SORT command directs the Batch Processor to execute the SORT-11 
program, which RSTS/E systems support. For additional information on 
the SORT-11 program, see the PDP-11 SORT/MERGE User's Guide. The 
$SORT control statement has the format: 

SSORT [job switches] [output[/OUTPUT]] [input[/INPUT]] [spec/SPEC] 
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Job switches, which you can abbreviate to the first three letters, 
define the sort process. When you specify more than one switch, 
separate each switch with a slash (/). The following are valid job 
switches: 


BATCH Switch 
/ALL[OCATION]:n 


/BLO[CKSIZE]:n 


/BUC[KETSIZE]:n 


/CON[TIGUOUS] 
/DEV[ICE]:x 


/FILfES]:n 


/FOR[MAT]:x:n 


Meaning 

For output, specifies the initial space 
allocation for the file. The value n is in 
the range 0 to 65535 blocks. If you do not 
specify an allocation, the default depends on 
the sort process (see /PROCESS). If /PROCESS 
is Record or Tag, the default is the input 
file size. If /PROCESS is Index or Address 
Routing, the default is the number of records 
sorted. 

For magnetic tape input or output, specifies 
the tape block size. The default is a 
512-byte block. 

For output, specifies the file's bucket size. 
The default is the bucket size of the input 
file. 

For output, specifies a contiguous file. The 
default is noncontiguous. 

For input, specifies the device to be used 
for scratch files, where x is a one- to 
four-character device name. 

For input, specifies the number of scratch 
files; you can specify from three to ten 
scratch files. 

For input, specifies the file's record format 
(x) and maximum record size (n). This switch 
is required. The value x can be: 

F (Fixed) 

S (Stream) 

V (Variable) 

U (Unknown) 

The default format is VARIABLE; you must 
specify a value n for the record size. 


/IND[EXEDSEQUENTIAL]:x For input, specifies indexed file 

organization. The value x specifies the number 
of keys. 
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BATCH Switch Meaning 


/KEY[S]:abm.n 

For input, specifies the sorting key field. 

If you do not specify a file in the command 
line, you must include this switch. You can 
specify a maximum of ten keys, separated by 
colons. For example: 

/KEY:abm.n:abm.n:...abm.n 

/PRO[CESS ] : x 

For input, specifies the sorting process. The 
value x can be: 

R (Record sort, the default) 

T (Tag sort) 

A (Address Routing) 

I (Index sort) 

/RELfATIVE] 

For output, specifies relative file 
organization. 

/SEQUENTIAL] 

For output, specifies sequential file 
organization. 

/SIZ[E]:n 

For'output, specifies the file's cluster size 


In the SSORT control statement, you can enter a maximum of three file 
specifications, separated by spaces: an input file, an output file, 
and a ispecification file. To distinguish these files, use the 
following switches, which you can abbreviate to the first three 


letters: 


SORT Switch 

Meaning 

INP[UT] The 

file to be sorted. 

OUT[PUT] The 

file to contain the sorted data. 

SPECIFICATION] The 

for 

file that contains the control information 
the sorting process. 


The Batch Processor uses a file specification without a switch as the 
file you want to sort. If you use the /SPECIFICATION switch, you 
cannot use the /KEYS and /PROCESS switches in the command line. If 
you do not give a specification file in the control statement, you 
must include the /KEYS switch in the command field to control the 
sorting process. Always include the /FORMAT switch in the command 
field. If you omit a type from the file specification, the Batch 
Processor uses .SRT as the type. 
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The $FORTRAN Command 

The $FORTRAN command calls the FORTRAN compiler. The $FORTRAN command 
has the format: 

$FOR[TRAN][/sw] [specification field[/sw]] [spec fields[/sw]] 

The following switches are valid in the command field: 

Switch Meaning 


/RUN 

Execute the previously compiled file. You can specify 
only an object file. 

/NORUN 

Compile the source program but do not execute the object 
file. 

/OBJECT 

Create the compiled file filename.OBJ, where the file 
name is that of the source file. The default is 
/NOOBJECT. 

/NOOBJECT 

Do not create an object file. This is the default. 

/LIST 

Produce the listing file filename.LST, where the file 
name is that of the source file. The default is /NOLIST. 

/NOLIST 

Do not produce a listing file. This is the default. 

/MAP 

Create the map file filename.MAP, where the file name 
is that of the source file. The default is /NOMAP. 

/NOMAP 

Do not create a map file. This is the default. 


You can use one of the following switches in the first specification 


field: 


/FORTRAN 

/SOURCE 

Both switches have the same meaning. They indicate the 
source file on which to operate. If a file specification 
lacks a switch, the Batch Processor assumes it is a 
source file. 

The optional 

specifications ending the format description define other 


files that you may need in the operation. You can use any of the 
following switches in the formats indicated. However, you can use 
each switch only once in the entire $FORTRAN command line. For 
example, you cannot use a switch and its negation anywhere in the same 
command line. For example, /LIST and /NOLIST cannot appear together 
in a command line. 
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File Specification 

file specification/LIST 

file specification/OBJECT 

file specification/MAP 

You can specify more than one 
using the following switch: 

file specification/LIBRARY 


Meaning 

Define the listing file as specified. 
Define the object file as specified. 
Define the map file as specified, 
library file in the command line by 


Each such specification is a library file that you want linked with 
the FORTRAN program. Library file specifications, delimited by 
spaces, can appear anywhere in the command line. 


Batch Operating Procedures 

This section describes how you request batch processing and how the 
Batch Processor generates output. 


Requesting a Batch Job Run 

To submit a job to the Batch Processor, run the QUE program and 
specify the control file or files as follows: 

$RUN $QUE 

QUE V9 RSTS V9 

#Q BA:BATJOB=FILEl,FILE2,FILE3.DAT 
# 

You normally queue a batch job to device BA:. The job and log files 
in this example are named BATJOB, and the files FILEl.CTL, FILE2.CTL, 
and FILE3.DAT are to be concatenated to form the control file. Log 
file BATJOB.LOG is to be printed after job completion, providing you 
did not specify the /NOQUE switch in the $JOB command or during 
start-up of the Batch Processor. Note that QUE schedules jobs on a 
strict priority basis, thus a high priority compute-bound job can slow 
processing. 


A- 30 



The Batch Processor Control Language 


Batch Job Processing 

As the Batch Processor reads the control file, it checks for command 
sequence and syntax validity. If the Batch Processor detects an 
error, it writes an error message to the log file, does not run the 
job, and continues to check the syntax in the remainder of the control 
f ile. 

A $MESSAGE/WAIT, a $MOUNT, or a $DISMOUNT/WAIT command causes the job 
to pause for an operator response. Until the operator takes action, 
the Batch Processor sends no further commands to the pseudo keyboard. 

If the Batch Processor detects no errors, it processes the job and 
creates a log file showing the sequence of commands processed during 
the course of the job. If you direct program output to KB:, the 
output appears after the command that runs the program. 

In the example that follows, the Batch Processor runs a job named 
J0B1. The control file contains the following sequence of commands: 

$JOB/NAME-J0Bl/LIMIT=4 
$ CREATE SUB1.BAS 

source statements 

$EOD 

$BASIC/BP2 LISTING/LIS MAIN/OBJ 
source statements 


$DATA 


data 

$PRINT SUB1.BAS 
$E0 J 

The following section describes each of the commands in the previous 
sample control file: 

$J0B/NAME=J0B1/LIMIT=4 

The Batch Processor assigns the name JOBl to the job. This name, 
along with the date and time of execution, appears in the job log. 
The Batch Processor sets an elapsed time limit of four minutes. If 
the job is not finished in four minutes elapsed time, the Batch 
Processor terminates the job and writes an error message in the log 
file. 
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5CREATE SUB1.BAS 

The Batch Processor creates the BASIC source file SUBl from data 
records that must follow the SCREATE command. 

$EOD 

The $EOD command signals the end of SUBl.BAS. 

SBASIC/BP2 LISTING/LIS MAIN/OBJ 

The BASIC-PLUS-2 compiler compiles the source statements that follow 
this command. The compiler writes the source statements into the 
newly created LISTIN.B2S file, and places the object data in the 
MAIN.OBJ file. The temporary task built file contains the executable 
image. 

SDATA 

The data to be read during execution of MAIN.EXE follows this command. 
SPRINT SUBl.BAS 

The Batch Processor prints the source file created by SCREATE 
SUBl.BAS. This command also terminates data input to MAIN.EXE. 

SEOJ 

This command signals the end of job JOBl. 


Error Procedures 

When the Batch Processor detects a syntax error, it does not execute 
the job. Instead, the Batch Processor continues to scan the control 
file and writes an error log listing all scanned commands and data, 
along with the appropriate error messages. The log file always 
indicates all command lines scanned. If the Batch Processor finds an 
error on a command line, it writes the error message following the 
command, marked with question marks (????). 

If no syntax errors occur, the Batch Processor writes the time of 
output of lines in the left margin of' the log. All normal terminal 
interaction corresponding to the commands appear in the log. 
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Table A-5 lists the Batch Processor error messages and their meanings. 
Table A-5: Batch Processor Error Messages 


| Message and Meaning | 

... 

I I 

| ?BATCH BEING SHUT DOWN j 

| The Batch Processor is going off line and the job must be j 

j terminated. 

I I 

| ?CANNOT INCREASE PRIORITY | 

A /PRIORITY:n switch appeared in the $JOB command. The user was j 
I privileged but specified a value for n greater than 127. Or, j 

| the user was nonprivileged and specified a value greater than j 

| - 8 . | 

| ?CANNOT USE THAT ACCOUNT 

| An account specification appeared in the $JOB command but the j 

| request did not come from a privileged user. ! 

I i 

| ?CONTINUATION MISSING | 

| The hyphen (-) character was the last nonblank character in a j 

| control statement to continue the statement on the next line, j 

| but the following line did not begin with a dollar sign ($) and j 

j a blank. 

| 7DEVICE NOT MOUNTED 

| A SDISMOUNT command was present but the device indicated had j 

| not been mounted. j 

I I 

| ’DISK MOUNT FAILURE | 

| The volume to be mounted was not correct (pack IDs did not | 

| match) or the device was in use by another job. 

I I 

| 7INVALID COMMAND j 

j An undefined command name followed the $ character in a j 

j statement but the /CCL command switch had not been specified in j. 

| the $JOB command. 

| 7INVALID SPECIFICATION FIELD 

j The specification given in a control statement is in the wrong j 

j format. j 

| ?INVALID SWITCH | 

j The switch used in the command field or in the specification j 

| field is undefined, in the wrong format, or is privileged. j 

| ?NO BATCH JOBS POSSIBLE AT THIS TIME 

j The Batch Processor requires a pseudo keyboard to execute a job j 

j but one is not available. Requeue your request. 
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Table A-5: Batch Processor Error Messages (Cont.) 

.. . 

| Message and Meaning ! 

+. . . 

i | 

| ?N0 SUCH ACCOUNT 

The account specified in the $JOB command or in a specification | 
field could not be found on the device. I 

I I 

| ’SEQUENCE NOT SUPPORTED YET 

The SSEQUENCE command is not available with this version of the j 

Batch Processor. I 

I I 

| ?TIME LIMIT EXCEEDED | 

Time specified in $JOB command is insufficient to execute the | 
job. Specify a larger limit by using /LIMIT*=nnn or /NOLIMIT | 
j switch. | 

| ?T00 MANY MOUNTED DEVICES 

j The job has requested mounting of more devices than the maximum | 

j (12) allowed by the Batch Processor. j 

| ?UNABLE TO LOG IN BATCH JOB 

j To execute a request, the Batch Processor logs a job into the | 

system using the account under which the job was queued or the j 

j account specified in the $JOB command. For some reason, the | 

j login procedure failed. For example, this can occur, if logins | 

j had been disabled. The Batch Processor requeues the job for | 

j later execution. j 

I I 

| ?UNMATCHED PARENTHESES | 

j An opening left parenthesis appears in a specification field j 

j but an accompanying closing right parenthesis is not found. j 

| ?UNMATCHED QUOTATION MARKS 

j Quotation marks (both single and double) must be paired in a j 

j control statement. j 

+.+ 
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PIP utility, 2-133 


/DETACHED JOBS switch 
SYSTAT utility, 2-219 
Device copying 

COPY utility, 2-1 
/DEVICE switch 

$SORT command, A- 27 
Dialogue 

RESTOR utility, 2-171 
Dialogue summary 

RESTOR utility, 2-180t 
DIRECT utility, 2-7 to 2-24 
CCL command, 2-17 
command line format, 2-7 
error messages, 2-23t 
file attributes, 2-18 to 2-23 
definition, 2-18 
list headings, 2-8 
listing directory files, 2-7 
octal attributes, 2-20 to 2-22 
description, 2-20 
listing, 2-20 
summary, 2-21t 
privilege required, 2-7 
RUN command, 2-7 
switches, 2-11 to 2-15 
/ALLOCATED, 2-11 
/ATTRIBUTE, 2-11 
/BACKWARDS, 2-11 
/BRIEF, 2-11 
/CLUSTERSIZE, 2-11 
/DATE, 2-11 
/DIRECTORY, 2-11 
/EXTENSION, 2-11 
/FAST, 2-11 
/FULL, 2-11 
/HEADING, 2-11 
/HELP, 2-11 
/LAST ACCESS, 2-11 
/LISTING, 2-11 
/MARKED FOR DELETION, 2-11 
/NAME, 2-11 
/NO MATCH, 2-11 
/OA, 2-20 

/OCTAL ATTRIBUTE, 2-11 
/OPEN STATUS, 2-11 
/POSITION, 2-11 
/PROTECTION, 2-11 
/RUN-TIME, 2-11 
/SA, 2-18 
/SIZE, 2-11 
/SLOW, 2-11 
/SUMMARY, 2-11 
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DIRECT utility 
switches (Cont.) 
summary, 2-lit 
/SYMBOLIC ATTRIBUTE, 2-11 
/TIME, 2-11 
/TYPE, 2-11 
/WIDE, 2-11 

symbolic attributes, 2-18 to 
2-19 

listing, 2-18 
summary, 2-18t 
wildcards, 2-9 

default interpretations, 2-10 
$DlRECTORY command 

Batch Processor, A-20 to A-21 
error conditions, A-21 
format, A-20 
Directory listing 
DIRECT utility, 2-7 
/DIRECTORY switch 

DIRECT utility, 2-11 
$DIRECTORY command, A-20 
FIT utility, 2-44 
FLINT utility, 2-53 
PIP utility, 2-129 
Directory switch options 
PIP utility, 2-130t 
/DISK STATUS switch 
SYSTAT utility, 2-218 
Disk structure report 
SYSTAT utility, 2-222 
$DISMOUNT command 

Batch Processor, A-26 
error conditions, A-26 
format, A-26 
DISMOUNT c ommand 

RESTOR utility, 2-191 
Dismount message 

RESTOR utility, 2-190 
/DOS switch 

FIT utility, 2-43, 2-45 
-E- 

Ending a message 

TALK utility, 2-236 
$EOD command 

Batch Processor, A-23 
$EOJ command 

Batch Processor, A-14 
/ERASE switch 

FLINT utility, 2-53, 2-63 


/ERASE switch (Cont.) 

PIP utility, 2-128 
Error conditions 
Batch Processor 

$DISMOUNT command, A-26 
$JOB command, A-14 
$MOUNT command. A-25 
$COPY command, A-19 
$DIRECTORY command, A-21 
$PRINT command, A-20 
$RUN command. A-22 
Error handling 

RESTOR utility, 2-196 
Error messages 

Batch Processor, A-33t 
COPY utility, 2-6t 
DIRECT utility, 2-23t 
FILCOM utility, 2-38t 
FIT utility, 2-49t 
FLINT utility, 2-66t 
GRIPE utility, 2-72t 
PIP utility, 2-137 
QUE utility, 2-1681 
RESTOR utility, 2-191 

dialogue messages, 2-191, 

2-192t 

interruption messages, 2-191, 
2 - 194t 

mount messages, 2-191 
processing messages, 2-191 
volume mount messages, 2-194t 
/ERROR switch 

§JOB command. A-13 
Errors 

bad block 

RESTOR utility, 2-197 
logic 

RESTOR utility, 2-197 
processing 

RESTOR utility, 2-196 
selection 

RESTOR utility, 2-196 
Examining address space 
ODT utility, 2-79 
/EXCEPT switch 

RESTOR utility, 2-177 
/EXECUTE switch 

$BASIC command, A-15, A-17, 

A-18 

Exempt files 

RESTOR utility, 2-177 
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/EXTEND switch 

PIP utility, 2-117 
/EXTENSION switch 

DIRECT utility, 2-11 

•F- 

FA option 

PIP utility, 2-113 
/FAST COPY switch 
COPY utility, 2-4 
/FAST switch 

DIRECT utility, 2-11 
PIP utility, 2-129 
FILCOM utility, 2-25 to 2-39 
command, single line, 2-28 
comparing files, 2-25 
error messages, 2-38t 
examples, 2-34 to 2-37 
privilege required, 2-25 
prompts, 2-26 to 2-28 
responding, 2-25 
RUN command, 2-25 
switches, 2-29 to 2-32 
/APPEND, 2-29 
/BASIC, 2-29 
/BLANK, 2-29 
/COMPARE, 2-29 
/LIMIT, 2-29 
/MATCH, 2-29 
/NO BASIC, 2-29 
/NO BLANK, 2-29 
/SUMMARY, 2-29 

using wildcards, 2-32 to 2-34 
File 
work 

RESTOR utility, 2-171 
File attributes 

DIRECT utility, 2-18 to 2-23 
PIP utility, 2-123 
File Compare Program 
See FILCOM utility 
File comparison 

RESTOR utility, 2-174 
File selection 

RESTOR utility, 2-171 
File specification 

RESTOR utility, 2-176, 2-176t 
File specification defaults 
Batch Processor, A-9 
File specification format 
Batch Processor, A-3 


File transfer 

between devices using PIP 
utility, 2-112 
disk to non-RSTS/E tape 
PIP utility, 2-113 
disk to tape 

PIP utility, 2-113 
RESTOR utility, 2-174 
tape to disk 

PIP utility, 2-114 
File Transfer Program 
See FIT utility 
File transfers 

PIP utility, 2-97 
Files 

comparing, 2-25 
/FILES switch 

$SORT command, A-27 
/FILESIZE switch 
PIP utility, 2-101 
FIP pool 

SYSTAT utility, 2-223 
FIT utility, 2-40 to 2-51 

compressing RTll files, 2-48 
description, 2-40 
error messages, 2-49t 
initializing RTll files, 2-46 
input devices, 2-42 
listing device directory, 2-44 
output devices, 2-42 
privilege required, 2-40 
RTll directory format, 2-48 
RUN command, 2-41 
switches 

/DELETE, 2-45 
/DIRECTORY, 2-44 
/DOS, 2-43, 2-45 
/LISTING, 2-44 
/NUMBER, 2-46 
/RSTS, 2-43 

/RTll, 2-43, 2-45, 2-48 
/SQUEEZE, 2-48 
/WATCH, 2-43, 2-45 
/ZERO, 2-46 

transferring files, 2-41 
command line format, 2-41 
Flexible diskette 
erasing 

FLINT utility, 2-63 
Flexible Diskette Interchange 
Program 

See FLINT utility 
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FLINT utility, 2-52 to 2-67 
description, 2-52 
erasing a diskette, 2-63 
erasing flexible diskette, 2-63 
error messages, 2-66t 
examples, 2-64 to 2-65 
IBM diskette headings 
directory, 2-55 
initializing a diskette, 2-63 
listing IBM diskette directory, 
2-53 

multidiskette transfer, 2-58, 
2-59, 2-62 

privilege required, 2-52 
RUN command, 2-53 
switches 

/DIRECTORY, 2-53 
/ERASE, 2-53, 2-63 
/TO IBM, 2-53, 2-60 
/TO RSTS, 2-53, 2-56 
/ZERO, 2-53, 2-63 
transferring diskettes, 2-52 
/FORMAT switch 

$SORT command, A-27 
Formatting post-mortem dump 
PMDUMP utility, 2-138 
/FORMS switch 

QUE utility, 2-156, 2-166 
$FORTRAN command 

Batch Processor, A-29 to A-30 
format, A-29 
/FORTRAN switch 

$FORTRAN command, A-29 
FORTRAN-IV 

running from batch job, A-29 
Free buffer status report 
SYSTAT utility, 2-222 
/FREE BUFFER switch 
SYSTAT utility, 2-218 
Full report abbreviations 
SYSTAT utility, 2-226t 
/FULL switch 

DIRECT utility, 2-11 

-G- 

/GO switch 

PIP utility, 2-120 
GRIPE utility, 2-68 to 2-72 
error messages, 2-72t 
GRIPE.TXT file 

comments in, 2-69 


GRIPE utility 

GRIPE.TXT file (Cont.) 
deleting, 2-71 
examining contents of, 2-70 
information in GRIPE.TXT, 2-69 
*LI ST command, 2-69 
LIST command, 2-70 
privilege required, 2-68 
*RESET command, 2-71 
RUN command, 2-68 
sending a message to system 
manager, 2-68 

-H- 

/HALT switch 

PIP utility, 2-127 
/HEADING switch 

DIRECT utility, 2-11 
/HELP switch 

COPY utility, 2-4 
DIRECT utility, 2-11 
PIP utility, 2-116 
HELP utility, 2-73 to 2-78 
CCL command, 2-76 
description, 2-73 
privilege required, 2-73 
RUN command, 2-73 
switches 

/OUTPUT, 2-76, 2-78 
/PROMPT, 2-76 
/HOLD switch 

QUE utility, 2-165 


•I- 

IBM diskette headings 
directory 

FLINT utility, 2-55 
IBM-RSTS diskette transfer 
FLINT utility, 2-52 
/IDENTIFY switch 
PIP utility, 2-127 
IGNORE command 

RESTOR utility, 2-198 
/IGNORE switch 

PIP utility, 2-120 
/INDEXED switch 

$SORT command. A-27 
Input devices 

FIT utility, 2-42 
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Input file specification 
PIP utility, 2-100 
/INPUT switch 

$COPY command, A-19 
SDIRECTORY command, A-20 
$SORT command. A-28 
/INSPECT switch 

PIP utility, 2-127 
Interrupt commands 

RESTOR utility, 2 -1881 
Interruption command prompt 
RESTOR utility, 2-188 
Interruption commands 
RESTOR utility, 2-187 

-J- 

/JCOPIES switch 

QUE utility, 2-156, 2-166 
$JOB command 

Batch Processor, A-ll to A-14 
error conditions, A-14 
format, A-ll 

specification field, A-13 
/JOB STATUS switch 

SYSTAT utility, 2-219 
/JOB switch 

SYSTAT utility, 2-218 
Jobs status report 

SYSTAT utility, 2-220 

-K- 

K command 

format, 2-164 
QUE utility, 2-164 
/KEYS switch 

$SORT - command. A-28 

-L- 

L command 

format, 2-161 
header lines, 2-162 
QUE utility, 2-161 
/LAST ACCESS"switch 
DIRECT utility, 2-11 
/LENGTH switch 

QUE utility, 2-154, 2-166 
/LIBRARY switch 

$FORTRAN command. A-30 
SYSTAT utility, 2-218 


/LIMIT switch 

FILCOM utility, 2-29 
$JOB command, A-ll 
Line continuation 

RESTOR utility, 2-178, 2-179 
List 

dialogue summary 

RESTOR utility, 2-186t 
*LIST command 

GRIPE utility, 2-69 
LIST command 

GRIPE utility, 2-70 
/LIST switch 

$BASIC command, A-15, A-17 
$FORTRAN command, A-29 
Listing device directory 
FIT utility, 2-44 
Listing IBM diskette directory, 
2-53 

Listing queue requests, 2-161 
/LISTING switch 

DIRECT utility, 2-11 
FIT utility, 2-44 
PIP utility, 2-129, 2-130 
Loadindex 

dialogue summary 

RESTOR utility, 2-1841 
/LOCK switch 

PIP utility, 2-134 
/LOG switch 

PIP utility, 2-122, 2-127 
/LOGICAL switch 

SMOUNT command, A-24 
/LPFORM switch 

QUE utility, 2-154, 2-166 

-M- 

M command 

description, 2-165 
format, 2-165 
QUE utility, 2-165 
Magnetic tapes 
mounting 

RESTOR utility, 2-190 
/MAP switch 

$BASIC command, A-16, A-18 
$FORTRAN command. A-29 
/MARKED FOR DELETION switch 
DIRECT utility, 2-11 
/MATCH switch 

FILCOM utility, 2-29 
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/MEMORY ALLOCATION switch 

SYSTAT utility, 2-219, 2-233 
$MESSAGE command 

Batch Processor, A-23 
format, A-23 

/MESSAGE RECEIVER switch 
SYSTAT utility, 2-218 
Message receivers report 
SYSTAT utility, 2-224 
Messages 

informational 

RESTOR utility, 2-198 
/MODE switch 

PIP utility, 2-101, 2-120 
QUE utility, 2-154, 2-166 
/MORE switch 

QUE utility, 2-159 
$MOUNT command 

Batch Processor, A-23 to A-25 
device list, A-25 
error conditions, A-25 
format, A-23 
MOUNT command 

RESTOR utility, 2-191 
Mount question 

RESTOR utility, 2-179 
Mounting disks 
logically 

RESTOR utility, 2-191 
Multidiskette transfer 

FLINT utility, 2-58, 2-59, 2-62 


-N- 

/NAME switch 

DIRECT utility, 2-11 
$JOB command. A-11 
/NEW FILE switch 
PIP utility, 2-121 
/NO ATTRIBUTES switch 
PIP utility, 2-121 
/NO BASIC switch 

FILCOM utility, 2-29 
/NO BLANK switch 

FILCOM utility, 2-29 
/NO COPY switch 
COPY utility, 2-4 
/NO CPU switch 

$JOB command, A-12 
/NO EXECUTE switch 
$BASIC command, A-15 


/NO HEADER switch 
QUE utility, 2-159 
/NO LIMIT switch 
$JOB command, A-12 
/NO LIST switch 

$BASIC command, A-15 
$FORTRAN command, A-29 
/NO LOG switch 

PIP utility, 2-127 
/NO MAP switch 

$BASIC command, A- 16 
$FORTRAN command, A- 29 
/NO MATCH switch 
. DIRECT utility, 2-11 
/NO NAME switch 

$JOB command. A-11 
/NO OBJECT switch 

$BASIC command. A-16 
$FORTRAN command, A-29 
/NO option 

PIP utility, 2-128 
/NO QUE switch 

$JOB command, A-12 
/NO REWIND switch 
PIP utility, 2-127 
/NO RUN switch 

$BASIC command, A-15 
$FORTRAN command. A-29 
/NO SUPERSEDE switch 
PIP utility, 2-121 
/NO WRITE switch 

$MOUNT command. A-24 
/NUMBER switch 
FIT utility, 2-46 


-O- 

/OA switch 

DIRECT utility, 2-20 
/OBJECT switch 

$BASIC command, A-16, A-17 
$FORTRAN command, A-29 
/OCTAL ATTRIBUTE switch 
DIRECT utility, 2-11 
Octal attributes 
description, 2-20 
DIRECT utility, 2-20 to 2-22 
listing, 2-20 
summary, 2-21t 
Octal Debugging Tool 
see ODT utility 


Index - 9 




ODT utility, 2*79 to 2*96 

accessing address space, 2-85 
accessing locations, 2-84 
block address, 2-94 
cautions when using, 2-79 
changing address space, 2-79 
changing byte locations, 2-80 
changing locations, 2-85 
changing word locations, 2-80 
characters and symbols, 2-83t 
error procedures, 2-96 
examining address space, 2-79 
examining byte locations, 2-80 
examining word locations, 2-80 
file question responses, 2-84t 
interpretive address quantities, 
2-95 

opening a relative location, 

2-88 

opening absolute location, 2-89 
opening location as a byte, 

2-85 

opening location as a word, 

2-85 

opening PC relative location, 
2-88 

opening preceding location, 

2-87 

opening relative branch offset 
location, 2-89 
printing ASCII format, 2-92 
printing location contents, 

2-91 

printing octal values, 2-80 
printing Radix-50 format, 2-93 
privilege required, 2-79 
relocation registers, 2-93 
returning to interrupted 
sequence, 2-91 
RUN command, 2-83 
specifying relative address, 

2-93 
/ON switch 

PIP utility, 2-125 
/OPEN FILES (O) switch 
SYSTAT utility, 2-219 
/OPEN FILES (W) switch 
SYSTAT utility, 2-219 
/OPEN FILES switch 

SYSTAT utility, 2-231t 
/OPEN STATUS switch 
DIRECT utility, 2-11 


Operational modes 

RESTOR utility, 2-171 
OPSER-Based Batch Processor 
See Batch Processor 
Output devices 

FIT utility, 2-42 
Output file specification 
PIP utility, 2-98 
/OUTPUT switch 

$COPY command, A-19 
HELP utility, 2-76, 2-78 
$SORT command. A-28 

-P- 

/PARITY switch 

COPY utility, 2-4 
$MOUNT command, A-24 
PIP utility, 2-133 
Peripheral Interchange Program 
See PIP utility 
/PHYSICAL switch 

SMOUNT command, A- 24 
PIP utility, 2-97 to 2-137 
CCL command, 2-97 
command line format, 2-98 
DCL command files, 2-103 
description, 2-97 
directory switch options, 

2 - 130t 

error messages, 2-137 
file attributes, 2-123 
file transfer 

disk to non-RSTS/E tape, 

2-113 

disk to tape, 2-113 
tape to disk, 2-114 
file transfers, 2-112 

command line format, 2-112 
input file specification, 2-100 
output file specification, 2-98 
preserving attributes, 2-112 
preserving data format, 2-112 
privilege required, 2-97 
RUN command, 2-97 
switches, 2-105t 
/ACCESS, 2-117 
/AFTER, 2-125 
/APPEND, 2-117 
/ASCII, 2-117 
/BEFORE, 2-125 
/BLOCK, 2-118 
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PIP utility 

switches (Cont.) 

/BLOCKSIZE, 2-113, 2-119 
/BRIEF, 2-129 

/CLUSTERSIZE, 2-101, 2-114, 
2-120 

/CREATE, 2-125 

/DATE LAST ACCESS, 2-125 

/DELETE, 2-128 

/NO option, 2-128 
/DENSITY, 2-133 
/DENSITY options, 2-133 
/DIRECTORY, 2-129 
/ERASE, 2-128 
/EXTEND, 2-117 
/FAST, 2-129 
/FILESIZE, 2-101 
/GO, 2-120 
/HALT, 2-127 
/HELP, 2-116 
/IDENTIFY, 2-127 
/IGNORE, 2-120 
/INSPECT, 2-127 
/LISTING, 2-129 
/LISTING Options, 2-130 
/LOCK, 2-134 
/LOG, 2-122, 2-127 
/MODE, 2-101, 2-120 
/NEW FILE, 2-121 
/NO ATTRIBUTES, 2-121 
/NO LOG, 2-127 
/NO REWIND, 2-127 
/NO SUPERSEDE, 2-121 
/ON, 2-125 
/PARITY, 2-133 
/PARITY options, 2-133 
/POSITION, 2-101 
/PRIORITY, 2-134 
/PROTECT, 2-101 
/PROTECTION, 2-98 
/QUERY, 2-127 
/RENAME, 2-129 
/RETAIN, 2-121 
/REWIND, 2-127 
/RMS, 2-113, 2-123, 2-124 
/RONLY, 2-101 
/RUN-TIME SYSTEM, 2-122 
/SINCE, 2-125 
/SLOW, 2-129 
/TODAY, 2-125 
/UNTIL, 2-125 
/UPDATE, 2-122 


PIP utility 

switches (Cont.) 

/VERIFY, 2-127 
/WATCH, 2-122, 2-127 
/WIPE, 2-128 
/WIPE OUT, 2-128 
/ZERO, 2-132 
transferring files, 2-97 
using wildcards, 2-101, 2-115 
PMDUMP utility, 2-138 to 2-148 
command line format, 2-139 
description, 2-138 
explanation of contents, 2-140 
formatting post-mortem dump, 
2-138 

privilege required, 2-138 
RUN command, 2-139 
/POSITION switch 

DIRECT utility, 2-11 
PIP utility, 2-101 
Post-Mortem DUMP program 
See PMDUMP utility 
Preserving 
attributes 

PIP utility, 2-112 
data format 

PIP utility, 2-112 
?PRINT command 

Batch Processor, A-20 
error conditions, A-20 
format, A-20 
/PRIORITY switch 
$JOB command, A-12 
PIP utility, 2-134 
QUE utility, 2-156, 2-166 
Privilege required 
Batch Processor, A-l 
COPY utility, 2-2 
DIRECT utility, 2-7 
FILCOM utility, 2-25 
FIT utility, 2-40 
FLINT utility, 2-52 
GRIPE utility, 2-68 
HELP utility, 2-73 
ODT utility, 2-79 
PIP utility, 2-97 
PMDUMP utility, 2-138 
QUE utility, 2-149 
RESTOR utility, 2-170 
SYSTAT utility, 2-216 
TALK utility, 2-235 
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/PROCESS switch 

SSORT command, A-28 
/PROMPT switch 

HELP utility, 2-76 
Prompts 

FILCOM utility, 2-26 to 2 8 

/PROTECT switch 

PIP utility, 2-101 
/PROTECTION switch 

DIRECT utility, 2-11 
PIP utility, 2-98 

-Q- 

Q command 

file specification, 2-157 
format, 2-153 
QUE utility, 2-153 
switches, 2-159t 
wildcards, 2-158 
Q command job output switches 
QUE utility, 2-154t 
/QUE switch 

$JOB command, A-12 
QUE utility, 2-149 to 2-169 
CCL command, 2-166 
commands, 2-151t 
description, 2-149 
error messages, 2-168t 
examples, 2-160 
K command, 2-164 
format, 2-164 
L command, 2-161 
format, 2-161 
header lines, 2-162 
listing queue requests, 2-161, 
2-164 

M command, 2-165 
description, 2-165 
format, 2-165 
privilege required, 2-149 
Q command, 2-153 

file specification, 2-157 
format, 2-153 
wildcards, 2-158 
Q command job output switches, 
2 -1541 

Q command switches, 2-159t 
QUE utility 
/SKIP, 2-154 
RUN command, 2-150 
S command, 2-164 


QUE utility 

S command (Cont.) 

description, 2-164 
submitting a batch job, A-30 
submitting batch jobs, 2-149 
switches 

/AFTER, 2-154, 2-156, 2-166 
/BINARY, 2-159 
/CONVERT, 2-154, 2-166 
/COPIES, 2-159 
/DELETE, 2-159 
/FORMS, 2-156, 2-166 
/HOLD, 2-165 
/JCOPIES, 2-156, 2-166 
/LENGTH, 2-154, 2-166 
/LPFORM, 2-154, 2-166 
/MODE, 2-154, 2-166 
/MORE, 2-159 
/NO HEADER, 2-159 
/PRIORITY, 2-156, 2-166 
/RESTART, 2-159 
/SEQUENCE, 2-165 
/SKIP, 2-166 
/TRUNCATE, 2-154, 2-166 
/TYPE, 2-156, 2-166 
/UNHOLD, 2-165 
/UPPERCASE, 2-154, 2-166 
/QUERY switch 

PIP utility, 2-127 

-R- 

/RELATIVE switch 

$SORT command. A-28 
/RENAME switch 

PIP utility, 2-129 
♦RESET command 

GRIPE utility, 2-71 
Resident libraries report 
SYSTAT utility, 2-224 
/RESTART switch 

QUE utility, 2-159 
RESTOR utility, 2-170 to 2-215 
ACCESS comparison, 2-177 
backup set, 2-172 
backup set expiration date, 
2-189 

bad block errors, 2-197 
bad blocks, 2-198 
batch control file, 2-179 
build listing file, 2-175 
comments, 2-179 
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RESTOR utility (Cont.) 

CONT prompt, 2-178 
control file contents, 2-179 
CREATION comparison, 2-177 
DCL command file, 2-175 
DCL command files, 2-171 
dialogue, 2-171 

dialogue error messages, 2-191, 
2 - 1921 

dialogue summary, 2-180t 
DISMOUNT command, 2-191 
dismount message, 2-190 
dismounting volumes, 2-189 
error handling, 2-196 to 2-198 
error messages, 2-191 
exempt files, 2-177 • 
file comparison, 2-174 
file selection, 2-171 
file specification, 2-176, 

2 - 176t 

file transfer, 2-174 
IGNORE command, 2-198 
informational messages, 2-198 
interruption command prompt, 
2-188 

interruption commands, 2-187, 

2 -1881 

interruption error messages, 
2-191, 2-1941 
keywords 

ACCESS, 2-176 
AFTER, 2-176 
BEFORE, 2-176 
CREATION, 2-176 
labeling information, 2-189 
line continuation, 2-178, 2-179 
list dialogue summary, 2-186t 
List example, 2-210 
Loadindex, 2-206 
Loadindex dialogue summary, 

2 -1841 

Loadindex example, 2-207 
Loadindex listing example, 

2-209 

logic errors, 2-197 
logically mounting disks, 2-191 
MOUNT command, 2-191 
mount error messages, 2-191 
mount question, 2-179 
mounting magnetic tapes, 2-190 
mounting volumes, 2-189 
operational modes, 2-171 


RESTOR utility (Cont.) 

privilege required, 2-170 
processing error messages, 

2-191 

processing errors, 2-196 
restore example, 2-199 
restoring pre-V9.0 files, 2-170 
RETRY command, 2-196, 2-197 
RUN command, 2-175 
running under batch, 2-179 
selection errors, 2-196 
SKIP command, 2-196, 2-197 
switches 

/EXCEPT, 2-177 
/SAVE, 2-175 
using wildcards, 2-176 
volume mount error messages, 
2-194 

work file, 2-171 
Restoring pre-V9.0 backed up 
files, 2-170 
/RETAIN switch 

PIP utility, 2-121 
RETRY command 


RESTOR utility, 2-196, 2-197 
/REWIND switch 

PIP utility, 2-127 
/RMS switch 

PIP utility, 2-113, 2-123, 
2-124 

/RONLY switch 

PIP utility, 2-101 
/RSTS switch 

FIT utility, 2-43 
RTll directory format 
FIT utility, 2-48 
/RTll switch 

FIT utility, 2-43, 2-45, 2-48 
SRUN command 


Batch Processor, A-22 
error conditions, A-22 
format, A-22 
RUN command 


COPY utility, 2-2 
DIRECT utility, 2-7 
FILCOM utility, 2-25 
FIT utility, 2-41 
FLINT utility, 2-53 
GRIPE utility, 2-68 
HELP utility, 2-73 
ODT utility, 2-83 
PIP utility, 2-97 
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RUN command (Cont.) 

PMDUMP utility, 2-139 
QUE utility, 2-150 
RESTOR utility, 2-175 
SYSTAT UTILITY, 2-216 
TALK utility, 2-235 
/RUN switch 

$BASIC command, A-15 
$FORTRAN command. A-29 
/RUN-TIME switch 

DIRECT utility, 2-11 
Run-time system report 
SYSTAT utility, 2-223 
/RUN-TIME SYSTEM switch 
PIP utility, 2-122 
SYSTAT utility, '2-219 


-S- 

command 

description, 2-164 
QUE utility, 2-164 
/SA switch 

DIRECT utility, 2-18 
/SAVE switch 

RESTOR utility, 2-175 
Sending a message 
TALK utilty, 2-236 
/SEQUENCE switch 
QUE utility, 2-165 
/SEQUENTIAL switch 
$SORT command, A-28 
/SINCE switch 

PIP utility, 2-125 
/SIZE switch 

DIRECT utility, 2-11 
$SORT command, A-28 
SKIP command 

RESTOR utility, 2-196, 2-197 
/SKIP switch 

QUE utility, 2-154, 2-166 
/SLOW switch 

DIRECT utility, 2-11 
PIP utility, 2-129 
Small buffers 
see FIP pool 
$SORT command 

Batch Processor, A-26 to A-28 
format, A-26 
SORT-11 

running from batch job, A-26 


/SOURCE switch 

$BASIC command, A-17 
$FORTRAN command, A-29 
/SPECIFICATION switch 
$SORT command, A-28 
/SQUEEZE switch 

FIT utility, 2-48 
Statement format 

Batch Processor, A-2 
Status reports 

SYSTAT utility, 2-216 
Submitting batch jobs 
QUE utility, 2-149 
/SUMMARY switch 

DIRECT utility, 2-11 
FILCOM utility, 2-29 
Switches 

COPY utility, 2-3 to 2-5 
summary, 2-3t 

DIRECT utility, 2-11 to 2-15 
summary, 2-llt 

FILCOM utility, 2-29 to 2-32 
PIP utility, 2-105t 
SYSTAT utility, 2-218t 
/SYMBOLIC ATTRIBUTE switch 
DIRECT utility, 2-11 
Symbolic attributes 

DIRECT utility, 2-18 to 2-19 
listing, 2-18 
/SYSTAT utility 
switches 
JOB, 2-218 

SYSTAT utility, 2-216 to 2-234 
busy devices report, 2-221 
CCL command, 2-233 
description, 2-216 
disk structure report, 2-222 
displaying status reports, 

2-216 

FIP pool, 2-223 

free buffer status report, 

2-222 

full report abbreviations, 

2 - 2261 

jobs status report, 2-220 
message receivers report, 2-224 
output devices, 2-217 
privilege required, 2-216 
resident libraries report, 

2-224 

RUN command, 2-216 

run-time systems report, 2-223 
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SYSTAT utility (Cont.) 
switches, 2-218t 
/ACCOUNT, 2-218 
/ATTACHED, 2'-218 
/BUSY DEVICE, 2-218 
/DETACHED JOBS, 2-219 
/DISK STATUS, 2-218 
/FREE BUFFER, 2-218 
/JOB STATUS, 2-219 
/LIBRARY, 2-218 
/MEMORY ALLOCATION, 2-219, 
2-233 

/MESSAGE RECEIVER, 2-218 
/OPEN FILES , 2 - 2311 
/OPEN FILES (0), 2-219 
/OPEN FILES (W) , 2-219 
/RUN-TIME SYSTEM, 2-219 
/TERMINAL, 2-218 
System manager 

sending a message to 
GRIPE utility, 2-68 


-T* 

TALK utility, 2-235 to 2-238 
communicating with others, 
2-235 

ending a message, 2-236 
example, 2-236 
privilege required, 2-235 
RUN command, 2-235 
sending a message, 2-236 
/TERMINAL switch 

SYSTAT utility, 2-218 
/TIME switch 

DIRECT utility, 2-11 
/TO IBM switch 

FLINT utility, 2-53, 2-60 
/TO RSTS switch 

FLINT utility, 2-53, 2-56 
/TODAY switch 

PIP utility, 2-125 
Transferring diskettes 
FLINT utility, 2-52 
transferring files 
FIT utility, 2-41 
/TRUNCATE switch 

QUE utility, 2-154, 2-166 
/TYPE switch 

DIRECT utility, 2-11 
QUE utility, 2-156, 2-166 


-U- 

/UNHOLD switch 

QUE utility, 2-165 
/UNTIL switch 

PIP utility, 2-125 
/UPDATE switch 

PIP utility, 2-122 
/UPPERCASE switch 

QUE utility, 2-154, 2-166 
Utility programs overview, 1-1 to 
1-5 

CCL command 

conflict with DCL commands, 
1-5 

DCL environment, 1-5 
non-DCL environment, 1-5 
CCL command advantages, 1-3 
summary description, 1-lt 
typical CCL command, l-4t 

-V- 

/VERIFY switch 

COPY utility, 2-4 ' 

PIP utility, 2-127 
/VISUAL ID switch 

§MOUNT command, A-24 

-W- 

/WAIT switch 

$MESSAGE command, A-23 
/WATCH switch 

FIT utility, 2-43, 2-45 
PIP utility, 2-122, 2-127 
/WIDE switch 

DIRECT utility, 2-11 
Wildcards 

DIRECT utility, 2-9 
FILCOM utility, 2-32 to 2-34 
PIP utility, 2-101, 2-115 
Q command, 2-158 
RESTOR utility, 2-176 
/WIPE OUT switch 
PIP utility, 2-128 
/WIPE switch 

PIP utility, 2-128 
Work file 

RESTOR utility, 2-171 
/WRITE switch 

$MOUNT command. A-24 
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-z- 


/ZERO switch 

FIT utility, 2-46 

FLINT utility, 2-53, 2-63 

PIP utility, 2-132 
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